Share dashboard content
Put dashboard data in front of someone else, whether that's a teammate mid-investigation or a viewer who never signs in to Coralogix at all.
Share content via:
- A widget URL: opens the dashboard focused on one visualization.
- A section URL: opens the dashboard scrolled to one section, already expanded.
- The full dashboard URL: opens the whole dashboard, laid out as you see it.
- Embed as an iframe: frames a live, fully authenticated Coralogix page inside your own application, webpage, customer portal, or unattended display, with no interactive login.
The first three are shared links: a URL into Coralogix that the recipient opens with their own account. They are the quickest option for anyone who already signs in to Coralogix and can open the dashboard themselves, and the recipient sees the same view you did.
Embedding is different in kind. There is no link to hand out, and nothing is exported: your application frames the Coralogix application itself and your server authenticates the session behind it. Use it for viewers who should never sign in to Coralogix.
Two more sections cover the mechanics that apply across all of these: Understanding dashboard link structure and Save behavior for all shared links.
What you need
- A saved dashboard
- The
team-dashboards:Readpermission, 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
widgetIDparameter. - Or select Maximize to open the widget’s enlarged view. This updates the browser URL with the widget’s
widgetIDparameter, 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.
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. 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:
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.
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.
https://<team>.eu2.coralogix.com/#/dashboards/<dashboard_ID>?widgetID=<target_ID>
- Replace
<team>with your team name - Replace
eu2.coralogix.comwith your regional Coralogix domain - Replace
<dashboard_ID>with the ID of your dashboard - Replace
<target_ID>with the unique ID of the widget or section you are sharing
Both widget and section links use the same widgetID URL parameter.
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.
Anyone with sufficient dashboard permissions can open the link and be taken directly to the widget or section.
Embed a dashboard in your own application
A shared link only works for someone who can sign in to Coralogix and already has access to that dashboard (for a public dashboard, that means TEAM-DASHBOARDS:READ). When the viewer shouldn't have a Coralogix account at all, embed the dashboard instead.
An embedded dashboard is the Coralogix application itself, rendered inside an <iframe> in your own page and pointed at the dashboard. It is fully authenticated, with no interactive login: a trusted server-side process in your environment establishes the session on the dashboard's behalf, so the view appears and stays live without anyone signing in. Typical uses:
- A dashboard inside a customer-facing portal, where each customer sees their own data.
- An internal application that shows a Coralogix dashboard alongside your own screens.
- An unattended display, such as a NOC wall or a kiosk monitor, that has to survive a restart without someone logging back in.
An embedded session is a real Coralogix session, not a read-only snapshot of one dashboard. Because the iframe loads the Coralogix application, every part of the UI that the session's user can reach stays reachable inside it, and the session's token can read that user's data through the API as well. What bounds the embed is the user it acts as: the session is scoped to a single team and carries that user's permissions, nothing narrower. It only works from the website origins you register, and disabling the client cuts it off immediately.
Framing one dashboard does not confine the session to that dashboard. Configure the client against a dedicated team member that holds the minimum the integration needs, usually read-only on the single team whose data the viewer should see, rather than a personal or admin account. Register only the origins that should be able to establish a session, and keep the client secret and challenge codes on your server.
To set one up, register an Embedded OAuth client. See Embedded client type for the client configuration, how the session and its renewal work, and how to request the integration brief and reference implementation.
Coralogix has no self-service option today for handing a dashboard link to someone outside your organization without embedding it. Sharing a link with an external viewer still requires giving them Coralogix access.
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 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.
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 to organize widgets in your dashboard.
- Register an Embedded OAuth client to put a dashboard in your own application.