Administrators can adjust how the Team Files app works to meet your team's needs and comply with company policies. 


About the Administrator Settings

As the name implies, these settings are only visible to users with Administrator privileges. All the settings on this page are accessible by entering Confluence settings and then clicking on the "Team Files" link on the sidebar under the "Configuration" section.


Allowed storage places

By default, users can connect folders from all the storage places supported by the Team Files app.

Administrators can easily restrict the usage of specific storage places to ensure that the use of the Team Files aligns with the company policies.

The options to connect clouds may differ depending on the app you installed. Example: Dropbox or Google Drive dedicated apps. 

Disable a storage place for all users

  1. Click the "Places" tab on the Team Files settings page

  2. Click the switch on the storage places you want to disable

  3. The switch changes to the off position to indicate the storage place was disabled, and users can no longer connect folders from that storage place.

Changes to these settings save automatically and apply immediately.

What happens to places the users connected before the Admin disabled them?

If a user connects a folder from a storage place that the Admin later disables, it becomes blocked inside the Team Files app. All connected folders from that place are blocked too, and if there are attached folders and files from a blocked storage place, the content won't be visible, and they'll display a warning mentioning the Admin blocked the access.

Re-enable a storage place for all users

  1. Click the "Places" tab on the Team Files settings page

  2. Click the switch on the disabled storage place you want to re-enable

  3. The switch changes to the on position to indicate the storage place is enabled, and users can connect folders from that storage place again.

Changes to these settings save automatically and apply immediately.


Require authentication

The Team Files app simplifies the authentication by default, favoring ease of use with simplified permissions. Admins can require users to authenticate with an account with access to connected folders to better control how files are shared, viewed, and edited.

What changes 

Keep in mind that this option requires users to sign in to each connected folder to view and edit the files to apply the correct permissions to each user. Learn more

With “Require Authentication” active, Admins must opt-in to enable support for public pages. Learn more

This setting replaces the previous "Permissions for editing documents on SharePoint and OneDrive" setting.


Applying "Require Authentication"

  1. Click the "Authentication" tab on the Team Files settings page

  2. Click the toggle to turn on the option.

Changing this setting saves automatically and applies immediately.


Deactivating "Require Authentication"

  1. Click the "Authentication" tab on the Team Files settings page

  2. Click the toggle to turn off the option.

Changing this setting saves automatically and applies immediately.


Preview of attached files and folders on public pages

In a space open to unauthenticated users, they can preview files and folders attached with Team Files to public pages by default.

With the “Authentication Required” option active, Admins have to opt-in to support the preview of files and folders attached with Team Files on public pages.

note

Unauthenticated users can’t edit the content of Team Files macros, even if the space allows them to edit pages.

Unauthenticated users can’t edit the content of Team Files macros, even if the space allows them to edit pages.


Attachments layout options

By default, the files and folders attached to Confluence pages use a regular header and appear in the collapsed view to use less space on the screen. It's easy to preview the file by clicking the arrow to open the expanded view, which uses the width of the page and is 464px tall by default.

The Admin can set different defaults for new macros.

Attachment header

Select the default size for the header of new macros:

Preview width

Select the default width for the preview:

Preview height

Select the default height for the preview:

Preview default visibility

Select the default behavior for the preview:

Changes to these settings save automatically and apply immediately.


Allowed Spaces

By default, all spaces can use the Team Files app. It's accessible with a link on the space sidebar and as a macro on pages to attach files and folders.

However, an Admin can specify which Confluence spaces can use the Team Files app. Removing the permission to use the app hides the file manager and macro for that space.

In the "Spaces" tab, you can see the current settings. There are three main options that you can select from the drop-down menu: 

Option 1: All spaces can use the app (default option)

It is the default option and means that every space has access to the Team Files app.

Option 2: Only selected spaces can use the app

Select this option if you only want to allow the Team Files app for some spaces.

Adding a space:

Click the "Add Space" button, start typing to select a space, and click the "Add" button. The space gets access to the app immediately.

note

Searching places

When searching for a specific space, please keep in mind that the Atlassian CQL search has limitations for texts that include any of these special characters:
+ - && || ! ( ) { } [ ] ^ " ~ * ? : \ /

If you space name includes one of these characters, you can search for the space key instead.

Searching places

When searching for a specific space, please keep in mind that the Atlassian CQL search has limitations for texts that include any of these special characters:
+ - && || ! ( ) { } [ ] ^ " ~ * ? : \ /

If you space name includes one of these characters, you can search for the space key instead.

Removing a space:

Search for the space you want to remove, click the "Remove" button and confirm. The app is hidden from the space immediately.

Option 3: The selected spaces can't use the app

Select this option if you only want to hide the Team Files app for some spaces.

Adding a space:

Click the "Add Space" button, start typing to select a space, and click the "Add" button. The app is hidden from the space immediately.

Removing a space:

Search for the space you want to remove, click the "Remove" button and confirm. The space gets access to the app immediately.

Disabling the Team Files app on space already using it hides the file manager link and all the attached files and folders to issues. The attachments reappear if the app is re-enabled.

Space owners can also toggle on/off the Team Files app, as long as the Admin allows.


Allowed users and groups

By default, all users and groups can use the Team Files app. It's accessible with a link on the project sidebar and as a macro on pages to attach files and folders.

However, an Admin can specify which users and groups can use the Team Files app. When someone doesn't have permission to use the app, the file manager and the macro are blocked.

You can see the current settings in the "Users & Groups" tab. There are three main options that you can select from the drop-down menu: 

Option 1: Everyone can use the app (default option)

It is the default option and means that every user and group can access the Team Files app.

Option 2: Everyone can use the app, only selected users and groups can connect folders

Select this option if everyone should be able to use the Team Files app, but only some users and groups can connect folders.

Adding a user or group:

Click the "Add User/Group" button, start typing to select a name, and click the "Add" button. The user or group gets access to connect folders immediately.

Removing a user or group:

Search for the user or group you want to remove, click the "Remove" button and confirm. The option to connect folders is hidden from the user or group immediately.

Option 3: Only selected users and groups can use the app and connect folders

Select this option if you only want some users and groups to use the Team Files app, and specify who can connect folders.

Adding a user or group:

Click the "Add User/Group" button, start typing to select a name, and click the "Add" button. The user or group gets access to the app immediately.

Connect folder permission:

Use the toggle button to determine if a user or group can connect folders.

Removing a user or group:

Search for the user or group you want to remove, click the "Remove" button and confirm. The app is blocked for the user or group immediately.


Wrap-up

On this page, you learned about all the Admin settings available. We'll add more Admin settings as needed when we introduce new features. 

If you still have questions or require other global settings, visit our support portal to send us your questions or feature requests. Our team is always happy to help.