Permissions [TF CC]
- Miguel Jesus
Learn how to set permissions for connected folders.
About permissions
You can set different permissions for the connected folders to tailor the app experience to your team's needs. You can decide whether other people can view the folders you connect to and whether they can edit the content or download files. If you are familiar with Confluence's permissions for pages, you'll feel right at home.
Setting folder permissions
You can set permissions when connecting a folder in the "Permissions" tab or from the File Manager at any moment by clicking the lock icon.
The "Permissions" tab shows the current settings and how they affect your connected folder.
There are three main options that you can select from the drop-down menu:
Option 1: Anyone can view and edit (default option)
It is the default option, which means everyone with access to the Confluence Space can view and edit the content of the connected folder.
Option 2: Editing restricted
Everyone can view the folder and its content, but only the person who attached it (the owner) can edit it. The owner can also grant permission to download files or edit documents to specific people, groups, and roles.
Option 3: Viewing and editing restricted
Nobody has access to the folder; only the owner can view it and edit its content. Only people, groups, or roles added by the owner will have permission to view the folder or edit its content.
Granting permissions to specific people, groups, and roles
Select the "Editing restricted" or "Viewing and editing restricted" option from the combo box. New fields appear, and a list of the current permissions shows what "Everyone" and the owner can do with the folder:
Click the input box to start typing a name, group, or role, or select one directly from the menu.
Select the permissions to grant (only download or edit, that includes download).
Click the "Add" button.
The list will be updated to include the new addition. You can add as many entries as you need and click the "Connect" button (when connecting a folder) or the "Apply" button (when editing permissions).
Updating permissions
The permissions modal allows you to change any person's permissions, group, or role. The connected folder owner can change the permissions anytime by returning to the permissions modal. The owner can add more people and groups or revoke granted permissions by clicking the "Remove" button.
How permissions work
Please keep in mind that permissions are additive. If a person can only view a folder as an individual and is part of a group that can edit, this person can edit the folder, as Team Files combines all the permissions.
Files and folders attached to pages will only be visible to people with permissions granted in the folder.
When you use the macro to attach files and folders to a page, Team Files uses the connected folder's permissions at that moment. If you change the folder's permissions, the macro's attachments will not get the updated permissions. You must attach them again if you need them to use the new permissions.
Permissions override
The Team Files app simplifies access to shared content by default, favoring ease of use with simplified permissions. This default overrides file permissions set in SharePoint, OneDrive, Box, Dropbox, Google Drive, and Egnyte for folders connected to Confluence. The original storages are unchanged and keep the permissions set.
Admins can require users to authenticate with an account with access to the connected folders to respect the set permissions in the storage. Use the "Replicate storage permissions" setting with folder permissions to control better how files are shared, viewed, and edited.
Wrap up
Now you know how to set permissions for your connected folders to your pages and make changes to your macros. Don't forget you can connect more folders from the file manager.
If you still have questions about the topics covered on this page, visit our support portal and send them to us. Our team is always happy to help.