About permissions

You can set different permissions to 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 Jira's permissions for issues, 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.

Open

Open

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 Jira Project 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

Everyone has no 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

1. 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:

2. Click the input box to start typing a name, group, or role, or select one directly from the menu.

3. Select the permissions to grant (only download or edit, that includes download).

4. 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 will be able to edit the folder, as Team Files combines all the 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 the folders you connect to your projects. 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.