> ## Documentation Index
> Fetch the complete documentation index at: https://docs.athelas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sharing a Dashboard

#### At a Glance

Dashboards you build are private to you until you share them. Sharing gives specific people at your practice access to a dashboard, at the level you choose: one dashboard for your whole billing team, another only for yourself, a third for the two people who need it.

Out-of-the-box templates work differently. Anyone with access to [Dashboards](https://docs.athelas.com/insights_biller/analytics/dashboards.md) sees the templates their role allows, so there is nothing to share. To share a template with specific people, duplicate it and share your copy. See [Sharing a template](#sharing-a-template).

> [!WARNING]
>
> Dashboards built before sharing turned on are now private to the person who built them. Nothing was deleted and nothing needs rebuilding. If your team relied on one of those dashboards, its owner opens it, selects **Share**, and adds the people who should see it.

## Access levels

Every person on a dashboard has one of three access levels.

| **Access level** | **What they can do** |
| :- | :- |
| **Owner** | Open the dashboard, change anything on it, and decide who has access: add people, change their level, remove them, and make other people owners. Owners can also delete the dashboard. |
| **Editor** | Open the dashboard and change it: rename it, edit the description, add, remove, and rearrange sections and tiles, and change how a tile is displayed. Everyone with access sees their changes. Editors can't change who has access or delete the dashboard. |
| **Viewer** | Open the dashboard, read every tile, drill into metrics, and download CSVs. Viewers can change the filters for their own view, but they can't change the dashboard itself. |

**Setting goals** on a tile takes **Editor** or **Owner** access and the **Edit all dashboards** permission on your role. A goal belongs to the metric across your practice, not to one dashboard. See [Manage Staff & Permissions](https://docs.athelas.com/insights_admin/my_practice/manage_staff_permissions.md#roles).

When you create a dashboard, or duplicate one, you become its only owner. Duplicating a dashboard does not copy its sharing, so your copy starts private.

**Note:** At every access level, filters only change your own view. Nobody else sees your filter selections, and sharing a dashboard doesn't share filters with it.

## Sharing with your team

1. Open the dashboard and select **Share** in the top right. Everyone with access sees the button, but only owners can add people or change access.

   ![An open dashboard with the Share button highlighted in the header, next to Customize Dashboard](https://mintlify.s3.us-west-1.amazonaws.com/air_athelas/images/insights_biller/analytics/dashboard_sharing/dashboard_sharing_1.webp)

   Share in the dashboard header

   You can also choose **Share** from the **⋮** menu on the dashboard's card in the gallery.

   ![The menu on a dashboard card in the gallery, with Share highlighted](https://mintlify.s3.us-west-1.amazonaws.com/air_athelas/images/insights_biller/analytics/dashboard_sharing/dashboard_sharing_2.webp)

   Share in a dashboard card's menu

2. In **Add people by name or email**, search for a colleague. You can add anyone at your practice.

   ![The Share dialog open over a dashboard, with the people search list open](https://mintlify.s3.us-west-1.amazonaws.com/air_athelas/images/insights_biller/analytics/dashboard_sharing/dashboard_sharing_3.webp)

   Search for people to add

3. Each person you add starts as a **Viewer**. To give someone more access, select the level next to their name and choose **Editor** or **Owner**.

   ![The Share dialog open over a dashboard, with the access level menu open next to a newly added person](https://mintlify.s3.us-west-1.amazonaws.com/air_athelas/images/insights_biller/analytics/dashboard_sharing/dashboard_sharing_4.webp)

   Pick a new level next to their name

4. Select **Done**. Changes save as you make them, and the dashboard shows up in each person's gallery right away.

![The Share dialog open over a dashboard, listing the people with access, with Done highlighted](https://mintlify.s3.us-west-1.amazonaws.com/air_athelas/images/insights_biller/analytics/dashboard_sharing/dashboard_sharing_5.webp)

Select Done when you're finished

To change someone's access later, open **Share** again and pick a new level next to their name. To take it away, choose **Remove access** from the same menu.

**Not an owner?** **Share** still shows who has access, with a note that only owners can share. Select the email button, for example **Email Jordan**, to send an owner a request to add someone.

**Copy Dashboard Link** in the dialog copies a link to the dashboard. The link only opens for people who already have access.

> [!NOTE]
>
> A dashboard always needs at least one owner, so if you're its only owner, you can't lower your own level until you make someone else an owner. Nobody can remove themselves: lower your own level instead, or ask another owner to remove you. Once you lower your own level, you can no longer share the dashboard, and only another owner can undo the change.

You can add someone whose role doesn't include Dashboards, and the dialog won't warn you. They can't open the dashboard until your practice's admin adds Dashboards to their role. See [Manage Staff & Permissions](https://docs.athelas.com/insights_admin/my_practice/manage_staff_permissions.md#roles).

> [!TIP]
>
> ✨**Smart Tip:** Sharing controls who can open a dashboard, not what data they see. The numbers on each tile follow the viewer's role: the **All providers' data** and **All assignees' data** permissions decide whether they see the whole practice or only their own slice. Admins set these on roles under **Settings → My Practice → Team Members** (see [Manage Staff & Permissions](https://docs.athelas.com/insights_admin/my_practice/manage_staff_permissions.md#roles)). A colleague limited to their own provider or assignee data sees only their slice of each metric, even on a dashboard you shared with them.

## Sharing a template

Templates can't be shared directly, because anyone whose role includes a template already sees it. Selecting **Share** on a template offers to make you a copy you can share instead.

1. Open the template and select **Share**.

2. Select **Duplicate And Share**. Insights creates your copy, opens it, and opens its **Share** dialog.

   ![The Share a copy of this template dialog open over the Financial Health template, with Update role access, Cancel, and Duplicate And Share](https://mintlify.s3.us-west-1.amazonaws.com/air_athelas/images/insights_biller/analytics/dashboard_sharing/dashboard_sharing_6.webp)

   Share on a template opens this dialog

3. Add people as described in [Sharing with your team](#sharing-with-your-team).

Your copy is a regular dashboard: you can share it with specific people and change its metrics and layout. It won't get later updates to the template.

**Note:** If you can manage your practice's roles, the dialog also shows **Update role access**. Use it when a whole role should see the template, rather than sharing a copy with individuals. Everyone in the role sees the template and keeps getting its updates.

## Finding dashboards shared with you

Dashboards shared with you appear in your gallery next to your own dashboards and the templates. A badge on each card shows where you stand:

| **Badge** | **Meaning** |
| :- | :- |
| **Private** | You own it and nobody else has access. |
| **Shared** | You own it and have shared it with others. |
| **Viewer** | Someone shared it with you as a Viewer. Hover the badge to see who shared it. |
| **Editor** | Someone shared it with you as an Editor, so you can change it too. Hover the badge to see who shared it. |

When you open a dashboard someone shared with you, the same badge shows in the top right.

If a dashboard link doesn't open for you, the dashboard hasn't been shared with you. Ask one of its owners to share it.

## Seeing who has viewed a dashboard

Once people have opened a dashboard, avatars of its recent viewers appear in the top right, next to **Share**. Hover over them to see everyone who has viewed it and when each person last opened it, newest first. Everyone with access to the dashboard can see the list.

![A dashboard with the viewer avatars highlighted in the header and the Viewed by card open below them](https://mintlify.s3.us-west-1.amazonaws.com/air_athelas/images/insights_biller/analytics/dashboard_sharing/dashboard_sharing_7.webp)

Hover the viewer avatars to see who has opened the dashboard

* Only people who still have access are listed. If you remove someone's access, they drop off the list.
* Opening the dashboard again within 15 minutes doesn't count as a new view.
* Visits from Athelas staff, including support, aren't shown.

## Who can see what

| **What** | **Who decides** |
| :- | :- |
| **Opening Dashboards** | Your role. Your practice's admins control who can open the page. |
| **Templates** | Your role. Admins choose which templates each user sees. |
| **Your own and shared dashboards** | Sharing. You see the dashboards you created and the ones shared with you. Admin roles get no extra access to other people's dashboards. |
| **The numbers on a tile** | Your role's data permissions (see [Manage Staff & Permissions](https://docs.athelas.com/insights_admin/my_practice/manage_staff_permissions.md#roles)). Two people on the same dashboard can see different numbers if their permissions cover different providers, assignees, or facilities. |

### FAQ

> [accordion] Where did a dashboard I used to see go?
>
> It hasn't been deleted. Dashboards built before sharing turned on became private to the person who built them. Ask that person to open it, select **Share**, and add you.

> [accordion] Why can't I edit a dashboard I can see?
>
> You're a **Viewer**. You can still change the filters for your own view. To edit, ask an owner to make you an **Editor**: open **Share** and use the email button to send them the request.

> [accordion] Why can't I remove myself from a dashboard I own?
>
> Nobody can remove themselves from a dashboard. If there's another owner, lower your own level or ask them to remove you. If you're the only owner, make someone else an owner first.

> [accordion] Why are new dashboards private?
>
> So you decide who sees each one. Keep a dashboard to yourself while you build it, give your billing team view access when it's ready, and let one colleague help edit it. Every dashboard reaches the people it's meant for, and nobody else.

### Further Assistance

We're here to help! Please get in touch with [support@getathelas.com](mailto:support@getathelas.com) if you'd like some hands-on assistance.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.