How to set File Size Limits for Different User Groups

Table of Contents


It is possible to enforce different permissions for selected groups of users. This is useful for scenarios like

  • Increase the upload limits for Confluence admins to handle exception scenarios
  • Only the media team users can upload videos files which are large in nature
  • Restrict maximum size of images (png/jpg/gif) to 100kb, but allow PDF files to be up to 10mb
  • Limit customers to upload image files only whereas staff can upload pdf and office documents as well
  • Preventing abuse where users upload large zip files onto Confluence as their backup drive

How to change the setting

  1. Log in as Confluence administrator
  2. Go to Confluence Administration > Attachment Checker > Configuration

  3. Click on the Edit Settings button to
    1. Enable/Disable checking of file size limit based on groups
    2. Change the Error Message if the file size limit has exceeded
  4. To edit the file size limit, click on the Edit File Size Limit button

Editing File Size Limit

Each File Size Limit rule consist of the following components

ExtensionThe file extension applicable for this rule
Maximum SizeThe number that specify the maximum size of the file. It can only accept integer values. If you want to block upload of the type, you can use 0
Unit SizeKB or MB


A possible File Size Limit rule will be members of the staff-users group in Confluence can upload mp4 file type with file size up to 100 MB

The following operations are available in this screen

Enable/Disable the file size checking
  1. Click on the pen icon 

  2. Select the option in the radio button

  3. Click on the Tick icon to save the change
Change the group associated for the Group 1

The default group associated with Group 1 and Group 2 are confluence-administrators and confluence-users respectively. It is possible to switch to other groups.

  1. Click on the pen icon beside the group name

  2. Type to search for groups with matching name

  3. Select the group

  4. Click on the Tick icon to save the change
Add a new File Size Limit Rule for the group
  1. Enter the values at the top row of the group

  2. Click on the Add button on the first row of the section
Edit a File Size Limit Rule for the group
  1. Find the rule to be edited

  2. Mouse over the row to be edited. A pen icon will appear

  3. Click on the pen icon to toggle edit mode

  4. Update the value
  5. Click on the Update button to save
Delete a File Size Limit Rule for the group
  1. Click on the Delete button at the right side of the row

How it works

  • The default setting for Group 1 is confluence-administrators group
  • The default setting for Group 2 is confluence-users group
  • When a file is uploaded, it will determine the user performing the upload belongs to which group. The sequence of checking is in the workflow diagram below