Build dashboards
Collections
Group dashboards with the datasets they use.
A collection holds dashboards and the datasets they are built from, for a team or for a group of customers. This page covers creating a collection, attaching datasets, and the collection's settings.
Before you start
You need an Admin or Author sign-in. To attach a dataset, create it first. See Connect and upload data.
Create a collection
- Open Collections and choose New collection.
- Give it a Name. A Description is optional.
- Choose Create collection.
The collection opens on its Dashboards tab. Its default tenant access and its datasets are set from its own tabs, below.
The collection's tabs
| Tab | What it holds |
|---|---|
| Dashboards | The collection's dashboards, as cards or a list. New dashboard is here. |
| Datasets | The datasets attached to the collection, and how many dashboards and charts use each one. |
| Settings | The name and description, the default tenant access for new dashboards, and deleting the collection. |
A dashboard belongs to one collection. A dataset can be attached to several.
Attach a dataset
- Open the collection's Datasets tab and choose Attach dataset.
- Pick one or more datasets from the catalog. A dataset already in this collection shows "In this collection".
- Choose Attach dataset.
Undo in the message that follows takes the attachment back. To create a new dataset straight into the collection, choose New dataset on the same tab.
Each tenant sees only its own rows of a dataset with a tenant key. A dataset with no tenant key that is shared shows every row to every tenant. See Key concepts.
Detach a dataset
In the Datasets tab, choose Detach on the dataset's row, then Detach again to confirm. The dataset, its data, and the other collections it is in are not changed.
A dataset that a dashboard in this collection still uses cannot be detached. The app shows "In use here" with links to those dashboards. Remove the charts that use it first.
Dashboards in the collection
In the Dashboards tab, choose New dashboard to start one. Each dashboard's menu (the ⋯ button, or a right-click on its row) offers:
| Action | What it does |
|---|---|
| Open | Opens the dashboard's page. |
| Edit | Opens it in the builder. A Live dashboard shows "Unpublish to edit" instead. |
| Publish & share… | Opens the Publish & share panel. See Publish and share. |
| Rename | Renames it in place. |
| Delete | Deletes it. |
You can filter the list by Status (Draft or Live) and by author. You can sort it by name or by when it was last updated.
Settings
| Setting | What it does |
|---|---|
| Details | The collection's Name and Description. Choose Save changes. |
| Default tenant access for new dashboards | Visible, Customizable, or None. New dashboards in the collection start at this level; dashboards already there keep theirs. Only an Admin can change it. |
| Danger zone | Delete collection. |
If no default is stored, new dashboards in the collection start at None. A new collection gets Visible as its default.
Delete a collection
Only a collection with no dashboards can be deleted. Delete its dashboards first.
- Open the collection's Settings tab.
- Under Danger zone, choose Delete collection, then confirm.
The collection and its dataset attachments are removed. The datasets themselves stay in Datasets.
Common problems
| What you see | What to check |
|---|---|
| Detach is refused with "In use here" | A dashboard in the collection still has a chart on that dataset. Follow the links and remove those charts. |
| Delete collection is not available | The collection still has dashboards. The message lists them. |
| The default tenant access cannot be changed | Only an Admin can change it. |