Team Folders are a form of access control for your dashboards. They enable you to deliver dashboards and delegate control to different teams within your organisation (or to different clients if you are a service provider). You can customise which users see which dashboards, and choose to delegate authoring permissions to different users.
Dashboard Server Enterprise edition (or above) is required for access to the Splunk tile, ServiceNow tile, Azure App Insights tiles, High Availability, and Team Folders.
For more information about licence pricing see pricing information.
To upgrade please contact email@example.com
To check the licence edition you are using see How to check which licence key is being used.
Where do I find a Team Folder?
A Team Folder appears in the navigation like a regular folder. Only users who have view permissions on the folder will see the folder and the dashboards in it.
When would I use a Team Folder?
By using Team Folders, you can customise which users can view or edit which dashboards.
Viewing: Limiting access to dashboards with Team Folders can be useful for security or operational reasons, and to simplify the SquaredUp experience for your different teams.
Editing: Giving users authoring permissions for a Team Folder enables them to create and customise the dashboards in the Team Folder. This means that normal users who are not SquaredUp administrators can be dashboard authors.
Team folders use roles to assign permissions to Active Directory groups or users to control what level of access they have to the Team Folder and content within it.
Permissions can be edited on the Team Folder settings page, including a default role that applies to any user not specified in the role list.
|View||Allows the user or group to see the Team Folder in their navigation bar and view all dashboards within it.|
Has the same permissions as the view role, but with the added ability to edit content within the Team Folder.
Users with the author role have permission to:
By default, only SquaredUp administrators can create and edit SQL and Web API queries. To delegate permissions to other users see Signing and Security.
Has the same permissions as the author and view roles, but with the added permissions to edit the Team Folder itself.
Users with the owner role have permission to:
|No Access||Hides the Team Folder for this user or group.|
What permissions do SquaredUp administrators have?
SquaredUpAdministrators have the same access as owners to all Team Folders, along with the ability to create and delete Team Folders. SeeHow to make a user a SquaredUp Dashboard Server administrator.
Who can be an author or an owner?
Owner and author roles can be given to any user.
What permissions are needed to move content between Team Folders?
Only Administrators and users with the same permissions in two Team Folders can move content between those Team Folders.
Can Team Folders be nested?
Team Folders are designed to delegate permissions for groups of dashboards to different teams, it is not designed as a per-dashboard access control mechanism like you'd find on a file system. For this reason, Team Folders cannot be nested; a Team Folder cannot contain another Team Folder, and permissions are not ‘inherited’, like you would find in folders on a file system.
Creating a new Team Folder
To create a new folder and simultaneously make it a Team Folder:
- In SquaredUp click on the right-hand menu ☰ > system > team folders
Click the create button under the list of Team Folders. This will create a new Team Folder at the root of the navigation bar.
- Give the folder a name.
- By default everyone is given the role no access. For the users you wish to be able to see this folder, add individual users or an Active Directory/Windows group to the list and give them the view role.
- If you wish you can also add individual users or a group of users and give them the author or owner roles.
- You, other Administrators or any authors or owners can now add dashboards, or sub-folders to this Team Folder.
An existing normal folder can be converted into a Team Folder. All content in the folder will be retained in the Team Folder and by default it will be given view, allowing anyone to see it. A folder can only be converted into a Team Folder by admins, and once a folder has been converted to a Team Folder it cannot be turned back into a normal folder.
- In SquaredUp navigate to the folder you wish to make into a Team Folder.
Click on the view folder settings button at the top right of the page.
Click the permissions button
Click the convert button.
The folder is converted into a Team Folder and the permissions box is visible so that straight away you can adjust permissions to control who can view and edit the contents of the folder. By default, everyone is given view access to the Team Folder and the dashboards within it:
- You will probably want to change the everyone group to a role of no access.
- For the users you wish to be able to see this folder, add individual users or an Active Directory/Windows group of users to the list and give them the view role.
- If you wish you can also add individual users or an Active Directory/Windows group of users and give them the author or owner roles.
Deleting a Team Folder
Only Administrators have the ability to delete Team Folders. Deleting a Team Folder causes all of the content within the Team Folder to also be deleted, including any unpublished drafts in the Team Folder.
Moving a Team Folder
Administrators can move a Team Folder from the right-hand menu ☰ > system > edit navigation by editing the top level navigation bar. See .
A Team Folder cannot be moved into another Team Folder.
Sorting the dashboards within a Team Folder
Each folder has its own settings page which shows the contents of the folder. Administrators and users with author or owner permissions to a Team Folder can go into the folder settings page to sort published dashboards within the folder or add subfolders.
- In SquaredUp navigate to the Team Folder.
Click on the view folder settings button at the top right of the page.
Click on the edit this folder button.
Click on the dashboard 'handle' to drag it to a new position.
Moving a dashboard in or out of a Team Folder
Users with author or owner permissions can move a dashboard out of a Team Folder and into another Team Folder, if they have author or owner permissions on both Team Folders.
Administrators can move a dashboard out of a Team Folder and onto the global navigation bar, or into another Team Folder.
Browse to the dashboard you want to move. Alternatively, you can also open a dashboard from the Team Folder settings page by clicking on the view dashboard button.
Only Administrators can move a globally viewable dashboard into a Team Folder, as only Administrators have permissions to edit the globally viewable dashboard.
Click the edit this dashboard button:
Click the move button:
The team folder dropdown list will show all the Team Folders you have permissions as author or owner and are therefore able to move this dashboard in to. Only Administrators will see the everyone option in this dropdown list as only they can add dashboards to the global navigation structure
Select the folder you want to move the dashboard in to.
If there are other dashboards in the Team Folder, drag your dashboard into position in the navigation structure.
Click the move button to complete the move.
Enabling a dashboard in a Team Folder for Open Access
If you share a dashboard within a Team Folder as (What is Open Access?) by generating an Open Access URL, this dashboard will potentially be viewable by anyone, and viewing will not be controlled by the Team Folder permissions.