Overview of Folders
Folders allow you to organize your workbooks and saved queries, and share them with your workspace or with specific teammates.
Folders you have access to, whether they were created by you or shared with you or your workspace, will automatically appear in your workspace sidebar.
To create a folder, select the ‘New’ button in the top right corner of your Home and select ‘Folder’. Then, give your new folder a name.
You can move workbooks or saved queries into folders, and nest folders within other folders. To move any object into a folder, simply drag and drop it into the destination folder in your sidebar. Or, you can select 'Move' from the '…' menu next to any object in your workspace, and then select the destination folder.
Folder Permissions and Sharing
There are 3 levels of access for folders:
Must be invited: Only you (or teammates that you individually invite to the folder) can view, modify, delete, or set access levels on the folder or its contents. By default, your folder will be set to ‘Must be invited’.
Read Only: Users in your workspace can view the folder and its contents, but cannot modify them. For queries that are stored in folders, users can run the query but cannot modify it.
Edit: Users in your workspace can view, modify, delete, or set access levels on the folder and its contents. They can also move objects in and out of folders.
To share access to a folder and its contents, go to your Home, select the ‘…’ menu to the right of the folder, then click ‘Share’. Or, click in to the folder and hit the ‘Share’ button in the top right corner of the page.
Here, you can set permissions for your entire workspace, or invite specific teammates to the folder and set their permissions individually. Note: Viewers of your workspace cannot be invited to edit a folder, although they can be granted read only access.
By default, the permissions on workbooks, queries, or subfolders that are stored inside a folder (the “root” folder) will match the permissions of that root folder. This means that by inviting users to a folder, you are granting them access to that folder's contents.
Moving an object into a root folder updates its existing permissions to match those of your root folder. This means that teammates who were invited to the object but not to the root folder will lose access to that object.
To confirm who can access a workbook, query or subfolder stored inside a root folder, go to your folder and click ‘Share’ from the ‘…’ menu to the right of that object. Or, click in to the object and hit 'Share' in the top right corner.
To invite a teammate to an object stored inside a root folder, you’ll need to invite them to the root folder itself. To do this, click on ‘Update’ to open the permissions for the root folder, then invite your teammate via email and set their access level.
Frequently Asked Questions
What happens if I delete a folder?
If you delete a folder, all of the contents inside the folder will be deleted. To restore folders and contents that were mistakenly deleted, contact us at email@example.com.
Can I individually share access to an object that is stored in a folder?
Currently, access levels on objects stored inside folders cannot be individually adjusted. To invite a teammate to an object stored in a folder, you'll need to invite them to the folder itself.
Can I share edit access to folder for someone who is a Guest or Viewer of my workspace?
Viewers of your workspace cannot be invited to edit a folder. Guests can be invited to edit specific folders, but they will remain a Guest of your workspace more generally.