# Publish and share a dashboard

## Preview your dashboard

To preview a read-only version of your dashboard, select the **Preview** button in the top toolbar.

<img alt="Preview button" src="../../../assets/95727efb31a8563145635d1332f880cb67c44dcad28a4564510b4e4eb8568f7c.webp" width="300px">

Once in preview mode, you can interact with your dashboard as an end user would. You can also change the inputs you defined to see those changes would impact the view. Use the **Exit preview** button to go back to dashboard editing mode.

<img alt="Preview mode buttons" src="../../../assets/2ba0d2fe8764c07876502686c16e453b01fcc292749f7743dadc495cbe32ce33.webp" width="300px">

## Publish your dashboard

Once you finish editing your dashboard, you need to publish it to share it with other users. This will create a separate Foundry resource backed by your Quiver analysis. Publishing your dashboard will both create the resource and save the analysis.

<img alt="Publish button" src="../../../assets/8d94af4b91d2fb103d29181826d5656b889b5b6e753ff5f9a490c0658f8d31a4.webp" width="300px">

To publish, use the **Publish** button in the top toolbar. You will be prompted to select a location in Foundry in which to save your dashboard. The dashboard inherits the permissions of the folder in which you save it; for example, if you save it in your private folder, the dashboard will not be accessible by any user unless you manually grant them access. For more details on how permissions work, see [Share your dashboard](#share-your-dashboard) below.

:::callout{theme="danger" title="Read-time enforcement only"}
Row and column access controls (including [restricted views](../../security/restricted-views/index.md), [object security policies](../../object-permissioning/object-security-policies/index.md), and [property security policies](../../security/property-security-markings/index.md)) filter what each viewer can see in a dashboard. These controls do not extend to card exports, screen captures, or downstream visual functions. To keep data protected as it flows downstream, pair these controls with a [marking](../../security/markings/index.md) or [Classification-based Access Control](../../security/classification-based-access-controls/index.md). For the full model, see [Access control propagation](../../security/access-control-propagation/index.md).
:::

Each time you re-publish a dashboard, a new version will be saved.

## Share your dashboard

To view a dashboard, a user needs to have, at minimum, Viewer permissions. These permissions can be granted manually or inherited from permissions on the parent folder in which the resource is published.

To edit a dashboard, a user needs to have Editor or Owner permissions on **both** the dashboard and the underlying analysis.

| Dashboard permission | Analysis permission | What can be done |
| --- | --- | --- |
| Editor or Owner | Editor or Owner | Can edit and share the dashboard and the analysis. |
| Editor or Owner | Viewer | Can share the dashboard but cannot share the analysis. Cannot republish the dashboard as this requires saving the analysis. |
| Viewer | Editor or Owner | Can save the analysis but cannot save the updated dashboard. |
| Viewer | No access | Can view the dashboard but cannot update it. |
| Editor or Owner | No access | Can view the dashboard but cannot update it. |

## Open a published dashboard

You can open a published dashboard outside of the analysis by clicking the link inside the analysis or clicking on the resource in Foundry. This will open the dashboard in a new, read-only tab. Users who have the appropriate permissions (see above) will be able to open the backing analysis from this view and edit the dashboard by selecting the **Edit** button in the top right corner.