Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

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

...

Table of Contents
2
minLevel1
maxLevel1
outlinefalse
styledefault
typelist
printabletrue

...

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 Settings" link on the sidebar under in 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 use of specific storage places to ensure that the use of the Team Files aligns with the company policies.

...

Note

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

...

Turn off a storage place for all users

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

  2. Click the switch on the storage places you want to disableturn off;

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

Info

Changes to these settings save are saved automatically and apply applied immediately.

Note

What happens to places the users connected before the Admin

disabled

turns them off?

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

...

Turn on again a storage place for all users

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

  2. Click the switch on the disabled storage place you want to re-enableturn on again;

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

Info

Changes to these settings save are saved automatically and apply applied immediately.

...

Replicate storage permissions

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 Remember that this option requires users to sign in to each connected folder to view and edit the files to and apply the correct permissions to for each user. Learn more

With “Replicate storage permissions” 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 "Replicate storage permissions"

  1. Click the "Authentication" tab Simplified sharing (…)" section on the Team Files settings page;

  2. Click the toggle to turn on the option “Replicate storage permissions.

Info

Changing this setting saves automatically and applies immediately.

...

Deactivating "Replicate storage permissions"

  1. Click the "Authentication" tab Cloud storage access and permissions required" section on the Team Files settings page;

  2. Click the toggle to turn off the option “Replicate storage permissions.

Info

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.

...

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, or clicking the file name (or preview button) to open the full-screen preview.

The Admin can set different defaults for new macros in the Admin settings section dedicated to the preview options.

...

Attachment header

Select the default size for the header of new macros:

  • Regular: The standard size for the header of attached files and folders. It shows a big icon and additional details;

  • Compact: Uses a smaller icon and only shows the name of the file or folder;

  • Hidden for files: Completely hides the file header for files and forces the expanded preview option. Moving the mouse over the file will show a compact header.

...

Preview width

Select the default width for the preview:

  • Auto: The standard width for previews uses the available space;

  • Custom: Define a value for the width of the preview area.

...

Preview height

Select the default height for the preview:

  • Regular: The standard height for previews (464px);

  • Custom: Define a value for the height of the preview area.

...

Preview default visibility

Select the default behavior for the preview:

  • Collapsed: The standard option that hides the preview;

  • Expanded: Automatically shows the preview of files and folders. This option is required when selecting the "Hidden for files" header.

Info

Changes to these settings are saved automatically and applied immediately.

...

Confluence Native attachments

By default, users can preview and edit Confluence Native Attachments (i.e., files attached directly to the page using Confluence’s attachment option) with a dedicated Team Files macro. You can turn this off in the Admin settings if needed.

...

Turn off Confluence Native Attachments

  1. Select the “Confluence attachments” section in the Admin Settings;

  2. Click the toggle to turn off the option.

...

Turn on Confluence Native Attachments

  1. Select the “Confluence attachments” option in the Team Files Admin Settings;

  2. Click the toggle to turn on the option.

 

Info

Changes to these settings are saved automatically and applied immediately.

...

Cloud attachments

Users can use the Team Files macro to preview and edit cloud storage attachments by default. If needed, you can turn this off in the Admin settings.

...

Turn off Cloud Storage Attachments

  1. Select the “Cloud Storage attachments” section in the Admin Settings;

  2. Click the toggle to turn off the option.

Turn on Cloud Storage Native Attachments

  1. Select the “Cloud Storage attachments” option in the Team Files Admin Settings;

  2. Click the toggle to turn on the option.

 

Info

Changes to these settings

...

are saved automatically and

...

applied immediately.

...

Allowed

...

users and groups

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

However, an Admin can specify which Confluence spaces users and groups can use the Team Files app. Removing the permission When someone is not permitted to use the app hides , the file manager and the macro for that spaceare blocked.

In The current settings are in the "Spaces" tab, you can see the current settingsUsers & Groups" section. 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 space has access to All users and groups can access the Team Files app with the default option.

...

Option 2:

...

Everyone can use the app; only selected users and groups can connect folders

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

...

Adding a

...

user or group:

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

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 user or group:

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

...

Option 3:

...

Only selected

...

users and groups can

...

use the app and connect folders

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

...

Adding a

...

user or group:

Click the "Add SpaceUser/Group" button, start typing to select a spacename, and click the "Add" button. The app is hidden from the space immediatelyuser or group will have immediate access to the app.

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 space user or group you want to remove, click the "Remove" button, and confirm. The space gets access to the app immediately.

Note

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.

Info

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 app will be blocked for that user or group immediately.

...

Allowed Spaces

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

However, an Admin can specify which users and groups Confluence spaces can use the Team Files app. When someone doesn't have permission to use Blocking a space from using the app , hides the file manager and turns off the macro are blockedfor that space.

You In the "Spaces" section, 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:

...

All spaces can use the app (default option)

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

...

Option 2:

...

Only selected spaces can use the app

...

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

...

Adding a

...

space:

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

...

space will have immediate access to the app.

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 your space name includes one of these characters, you can search for the space key instead.

Removing a space:

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

...

Option 3:

...

The selected

...

spaces can't use the app

...

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

...

Adding a

...

space:

Click the "Add User/GroupSpace" button, start typing to select a namespace, 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 foldersapp is hidden from the space immediately.

Removing a

...

space:

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

Note

Blocking the Team Files app on space using it hides the file manager link and all the attached files and folders to issues. The attachments reappear if the app is allowed again.

Info

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

...

Import data

If your team previously used a different ikuTeam connector app, like SharePoint or Google Connector, and upgraded to, or plans to upgrade to, the Team Files app to get the complete set of features it offers, you can import the data from the connector and use it with the Team Files app.

...

An Admin needs to:

  • enter the admin settings;

  • click the Import data section;

  • Click the import button.

The importing process can take some time, depending on the size of your instance, but you don’t need to wait on the page.

When it finishes, you can check the audit log, which will show the start and finish time and how many pages were imported. If errors occur during the import process, you can repeat it.

...

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 settingsabout the topics covered on this page, visit our our support portal to and send them to us your questions or feature requests. Our team is always happy to help.

...