--- title: "Publish a dashboard" description: "Dashboards are designed to be shared with the rest of your team. This is why each dashboard can be opened as a live published version" url: https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/analytics-manager-dashboards-publish lang: pt lastUpdated: 2026-09-14 --- > For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/pt/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/pt/llms-full.txt. # Publish a dashboard ## Objective Dashboards are designed to be shared with the rest of your team. This is why each dashboard can be opened as a **live published version**. ![dashboards](/images/public-cloud/data-platform/product/am/dashboards/picts/live-overview.png) ## Publish a dashboard live Each dashboard created in the Analytics Manager can be opened in either: - the **editing interface**: users can edit the [whole configuration and preferences of the dashboard](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/analytics-manager-dashboards-edit.md), such as adding charts, filters, stories, etc. - the **live interface**: users can view the dashboard and interact with the filters to refresh the charts, but they cannot edit it ![dashboards](/images/public-cloud/data-platform/product/am/dashboards/picts/live-overview.png) _Example of a live dashboard_ ![dashboards](/images/public-cloud/data-platform/product/am/dashboards/picts/dashboards-overview.png) _Example of the edition interface of the same dashboard_ Each mode **has its respective URL**. The editing mode URL depends on the [version](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/analytics-manager-queries.md#versioning-queries) currently being edited. The live mode URL always stays the same, referencing the _shared\_id_ of the dashboard which stays the same across versions. :::info All URLs require to be [authenticated in the Project IAM and granted access to the dashboard](#grant-access-to-the-dashboard) to open them. ::: ### How to publish a version? A live version of a dashboard is published automatically based on the [deployed version of the repository](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/analytics-manager-queries.md#versioning-queries) containing the dashboard and its queries (i.e. charts). #### If your dashboard repository has only one version The dashboard is published **automatically at each modification**. This means that all modifications made by editors will be visible in real-time in the live dashboard. :::info Updates may take up to a few minutes to be visible in the live dashboard. ::: #### If your dashboard repository has two or more versions The dashboard is **published automatically when a new version of the repository is deployed**. The live dashboard always corresponds to the version in the deployed repository. This means that the editors can work on one version of the dashboard, while the viewers accessing the live dashboard will not see the modifications until the new version is deployed by the editor. ## Grant access to the dashboard Multiple viewers can be granted access to the live dashboard easily, without granting them the right to edit it. :::info First, note that both dashboard editors and viewers, will have to be registered in a Project's IAM in order to access it, even if they are external to the Platform. They will only access the data/dashboards associated to their [roles and groups](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/landing-page-iam-users.md). ::: The rest of this page aims to explain how to give read access to a live dashboard for your end-users. There are **two usual modes** for access control to a live dashboard. ### Basic access control By default, you can easily give end-users **full read access** to dashboards (the charts, tables and data they contain) - without giving any direct querying rights on the underlying databases. This is due to the _Basic_ access control mode which is set by default in the dashboard's preferences. ![dashboards](/images/public-cloud/data-platform/product/am/dashboards/picts/access-control.png) With this mode, you give individual access to users or groups to the live dashboard as a whole. This means that **all data contained in the charts and filters will be visible to people who are granted access**, only from the live dashboard. The _Grant access_ section shows all the users/groups from the [Identity Access Manager](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/landing-page-iam.md) that have either one of these roles: _**Admin**_, or _**Dashboard Viewer**_ set with a condition on the dashboard name. Those users can open and view the live dashboard. ![dashboards](/images/public-cloud/data-platform/product/am/dashboards/picts/grant-access-page.png) You can give access to new or existing users/groups from the _Grant access_ tab. Click on **New user/group** and choose between _New user/group_ and _Existing user/group_. :::warning Please note that you must have `write` permissions on [IAM users](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/iam-users.md) / [IAM groups](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/iam-groups.md) to use this feature. ::: ![dashboards](/images/public-cloud/data-platform/product/am/dashboards/picts/grant-access-add-user.png) Selecting existing users will give them the [IAM role](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/iam-roles-conditions.md) _Dashboard Viewer_, with a [condition](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/iam-roles-conditions.md#add-a-condition-when-binding-a-role) set on this specific dashboard. They will get access to the whole dashboard's data **only from the live dashboard**. ![dashboards](/images/public-cloud/data-platform/product/am/dashboards/picts/grant-access-add-existing.png) Adding a new user will add them in the Identity Access Manager with the role _Dashboard Viewer_ (with a condition set on this specific dashboard) and automatically generate credentials for them (see details below). They will get access to the whole dashboard's data only from the live dashboard. ![dashboards](/images/public-cloud/data-platform/product/am/dashboards/picts/grant-access-add-new.png) Since those users are usually external BI users and not the Platform users, they are likely to not need the Platform account. Instead,the Platform automatically generates a simple login and password for them through the **Project IAM's own authentication method** (called [**Project**](https://docs.ovhcloud.com/pt/guides/public-cloud/data-platform/iam-auth-providers.md#project)). With these credentials, automatically shared with them by email, they will be able to authenticate to the live dashboard's URL and view the dashboard. ### Fine-grained access control :::info This feature is coming soon! ::: ## Go further If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://www.ovhcloud.com/pt/professional-services/) to get a quote and ask our Professional Services experts for a custom analysis of your project. Ask questions, give your feedback and interact directly with the team building the Data Platform on the dedicated [Discord channel](https://discord.gg/ovhcloud). If you need support with your OVHcloud services, create a request in our [Help Centre](https://help.ovhcloud.com/csm?id=csm_get_help). Join our [community of users](https://community.ovhcloud.com/).