# Share dashboard content ## Collaborate using shared dashboard links Share links that point teammates to the exact data you want them to see. Use these links to direct attention to a specific widget, a key section, or the full dashboard view during investigations, reviews, or everyday analysis. ## What you need - A saved dashboard - The `team-dashboards:Read` [permission](https://coralogix.com/docs/user-guides/custom-dashboards/permissions/index.md), which allows you to view public custom dashboards ## Share a widget Use a widget link to open the dashboard focused on a specific visualization. - In the widget’s more actions menu, select **Share widget URL**. This copies a URL that includes the widget’s `widgetID` parameter. - Or select **Maximize** to open the widget’s enlarged view. This updates the browser URL with the widget’s `widgetID` parameter, which you can copy directly. Example share widget link: `https://onlineboutique.coralogix.com/#/dashboards/lRjT6YSeVGFsWsIuckFUK?widgetID=97e73431-94d5-46d6-921a-3e87e60473eb` For an explanation of each part of the link, see [Understanding dashboard link structure](#understanding-dashboard-link-structure). Anyone with access to the dashboard can open the link and view the widget in context. ## Share a section Use a section link to open the dashboard scrolled to a specific [section](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/sections/index.md). The section expands automatically. In the section’s more actions menu, select **Share section URL**. This copies a URL containing the section’s `widgetID` parameter to your clipboard. Example share section link: ```text https://onlineboutique.coralogix.com/#/dashboards/lRjT6YSeVGFsWsIuckFUK?widgetID=19521dba-2e89-4fa6-8631-8b20c8862b7b ``` For an explanation of each part of the link, see [Understanding dashboard link structure](#understanding-dashboard-link-structure). Anyone with access to the dashboard can open the link and jump directly to the section. ## Share the full dashboard To share the entire dashboard, select **Share Dashboard URL** in the dashboard more actions menu. This copies the URL to your clipboard. Use this when you want teammates to see the full layout rather than a specific widget or section. ## Understanding dashboard link structure Dashboard share links follow a consistent format. Each part of the URL determines what dashboard is opened, and which widget or section is brought into view. ```text https://./#/dashboards/?widgetID= ``` - Replace `` with your team name - Replace `` with your regional [Coralogix domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain/index.md) - Replace `` with the ID of your dashboard - Replace `` with the unique ID of the widget or section you are sharing Both widget and section links use the same `widgetID` URL parameter. Note If you set a dashboard slug, this slug replaces the dashboard ID in the URL path after `/dashboards/`. This applies to all shared dashboard links. To learn more about dashboard slugs, see [Manage Dashboard Settings](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/manage-dashboard-settings/#dashboard-slug). Anyone with [sufficient dashboard permissions](#what-you-need) can open the link and be taken directly to the widget or section. ## Save behavior for all shared links Shared links always include the last saved dashboard configuration and the current URL-encoded state. The dashboard configuration includes: - Which widgets and sections exist - How each widget and section is configured - Where widgets and sections are placed on the dashboard The URL-encoded state includes: - Time range selection - [Variable selections](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/create-and-manage-variables/index.md) for existing dashboard variables - Dashboard filter selections For example, a dashboard may include a metric filter named `City` that allows you to select one or more locations. If you choose **Brooklyn** and **Berlin** and then copy the dashboard URL, the selected values are included in the link. ```text https://onlineboutique.coralogix.com/#/dashboards/0TLCRF7eAnOd4hdOs1zXn?f-City=Brooklyn&f-City=Berlin ``` When someone opens the link, the dashboard loads with the same city filter selections already applied. You **must save the following changes** for them to be included in the shared dashboard: - Creating, deleting, or renaming dashboard variables - Creating, deleting, or renaming dashboard filters - Adding or modifying widgets or sections (including configuration and layout changes) When a link is shared, the saved configuration is combined with the URL-encoded state. This results in the following behavior: - **New widgets or new sections**: If you create widget or new section and share the link without saving, the dashboard loads the previous saved version, without your new widget or section. - **Modified widgets or sections**: If you edit a widget or section without saving, recipients see the previous saved version, without your changes. - **Variable and filter selections**: If you select a value for an existing variable or filter, the selection is included in the shared link because it is encoded directly in the URL. Saving is not required. - **Update time range selection**: If you change the time range selection, the update is included in the shared link because the time range is encoded directly in the URL. Saving is not required. ## Next steps Learn how to use [sections](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/sections/index.md) to organize widgets in your dashboard.