From 929ddcaa55a9c847dff3ee84c3180795e3e335a6 Mon Sep 17 00:00:00 2001 From: Jiawen Zhu Date: Fri, 12 Jun 2026 15:43:04 +0200 Subject: [PATCH] Update Widget Share URLs docs --- config/_default/menus/main.en.yaml | 10 +++--- content/en/dashboards/sharing/_index.md | 2 +- .../dashboards/sharing/widget_public_urls.md | 33 +++++++++++-------- .../widgets/configuration/_index.md | 9 ++--- 4 files changed, 30 insertions(+), 24 deletions(-) diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index 50801886641..607beb87d36 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -1747,24 +1747,26 @@ menu: url: dashboards/sharing/shared_dashboards parent: dashboards_sharing weight: 1002 - - name: Widget Public URLs + - name: Widget Share URLs identifier: dashboards_sharing_widget_public_urls url: dashboards/sharing/widget_public_urls + parent: dashboards_sharing + weight: 1003 - name: Secure Embedded Dashboards identifier: dashboards_sharing_secure_embedded_dashboards url: dashboards/sharing/secure_embedded_dashboards parent: dashboards_sharing - weight: 1003 + weight: 1004 - name: Share Graphs identifier: dashboards_sharing_graphs url: dashboards/sharing/graphs parent: dashboards_sharing - weight: 1004 + weight: 1005 - name: Scheduled Reports identifier: dashboards_reporting url: dashboards/sharing/scheduled_reports parent: dashboards_sharing - weight: 1005 + weight: 1006 - name: Guides url: dashboards/guide/ parent: dashboards diff --git a/content/en/dashboards/sharing/_index.md b/content/en/dashboards/sharing/_index.md index 6d7d4aef0bc..02f681a46a4 100644 --- a/content/en/dashboards/sharing/_index.md +++ b/content/en/dashboards/sharing/_index.md @@ -24,7 +24,7 @@ Shared visualizations allow you to display metric, trace, and log visualizations {{< whatsnext desc="How to share visualizations:" >}} {{< nextlink href="dashboards/sharing/shared_dashboards" >}}Shared dashboards: Generate a public link for users to access{{< /nextlink >}} {{< nextlink href="dashboards/sharing/graphs" >}}Share graphs: Generate an embed code{{< /nextlink >}} - {{< nextlink href="dashboards/sharing/widget_public_urls" >}}Widget Public URLs: Copy widgets as images to share outside of Datadog{{< /nextlink >}} + {{< nextlink href="dashboards/sharing/widget_public_urls" >}}Widget Share URLs: Copy widgets as images to share outside of Datadog{{< /nextlink >}} {{< nextlink href="dashboards/sharing/scheduled_reports" >}}Scheduled reports: Set a schedule to send email reports{{< /nextlink >}} {{< /whatsnext >}} diff --git a/content/en/dashboards/sharing/widget_public_urls.md b/content/en/dashboards/sharing/widget_public_urls.md index cb4e4e3535c..a71492228c2 100644 --- a/content/en/dashboards/sharing/widget_public_urls.md +++ b/content/en/dashboards/sharing/widget_public_urls.md @@ -1,6 +1,6 @@ --- -title: Widget Public URLs -description: Copy widgets as snapshot images and share them outside of Datadog. +title: Widget Share URLs +description: Copy widgets as images to share outside of Datadog. further_reading: - link: "/dashboards/sharing/" tag: "Documentation" @@ -12,32 +12,39 @@ further_reading: ## Overview -Widget Public URLs let you copy a dashboard widget as a static image and share it outside of Datadog. When you copy a widget with Cmd/Ctrl + C, Datadog generates a publicly accessible link to a screenshot of the widget as it appears on your screen. This link is placed on your clipboard. When you paste outside of Datadog (for example, into Slack or Microsoft Teams) the link renders as a snapshot image of your widget. +Widget Share URLs let you copy a dashboard widget as an image for use outside of Datadog. When you copy a widget with Cmd/Ctrl + C, Datadog creates an image of the widget and generates a share URL. The URL behavior depends on your organization's Widget Share URLs setting. -**Note**: Widget Public URLs is separate from the [Datadog Clipboard][1], which copies widgets for use within Datadog (in dashboards, notebooks, and incidents). It is also unrelated to the [Snapshots API][2], which programmatically captures metric graph snapshots. +Admins can choose how widget share links and previews work in [**Organization Settings > Public Sharing > Settings**][2]: + +| Mode | Behavior | +| --- | --- | +| **Public** | Anyone with the share URL can view the widget image without a Datadog account. Third-party apps that support link previews, such as Slack or Microsoft Teams, can render a thumbnail of the widget. Viewing the source widget with live data still requires a Datadog account. | +| **Private** | Share URLs are available only to authenticated users in the same Datadog organization. Public image URLs stop serving widget images, so third-party apps cannot render public image previews. Private preview unfurling is supported only in Slack, and only for Slack workspaces connected to the same Datadog organization. | +| **Disabled** | Users cannot generate new Widget Share URLs. Existing share URLs and image endpoints are unavailable while the setting remains disabled, and Slack cannot generate new unfurls for those URLs. | + +**Note**: Widget Share URLs is separate from the [Snapshots API][1], which programmatically captures metric graph snapshots. ## Prerequisites -This feature requires the **Widget Public URLs** setting to be enabled in your organization. To enable it, navigate to [**Organization Settings > Public Sharing > Settings**][3]. +This feature requires the **Widget Share URLs** setting to be set to **Public** or **Private** in your organization. -When enabled, copying a widget generates a publicly accessible snapshot image link. Anyone with the link can view the snapshot, regardless of whether they have a Datadog account. +Admin changes to the Widget Share URLs mode apply immediately to existing share URLs. -## Copy a widget as an snapshot image +## Copy a widget as a preview image 1. On any dashboard, hover over the widget you want to share. 2. Press Cmd/Ctrl + C, or click the share icon and select **Copy**. 3. Paste outside of Datadog using Cmd/Ctrl + V. -In tools that support link previews (such as Slack or Microsoft Teams), the pasted link renders as a snapshot image of the widget. +In tools that support link previews, the pasted link renders according to your organization's Widget Share URLs mode. In **Public** mode, the widget image is publicly accessible. In **Private** mode, public image previews are unavailable; Slack can render a private preview only when the Slack workspace is connected to the same Datadog organization. -## Disable Widget Public URLs +## Disable Widget Share URLs -To stop generating publicly accessible widget image links, disable the **Widget Public URLs** setting in [**Organization Settings > Public Sharing > Settings**][3]. After disabling, copying a widget no longer generates a public snapshot image link. Previously generated links are no longer accessible. +To stop users from generating widget share links and previews, disable the **Widget Share URLs** setting in [**Organization Settings > Public Sharing > Settings**][2]. After disabling, copying a widget no longer generates share links or previews, and previously shared URLs are no longer accessible. If the setting is later changed back to **Public** or **Private**, previously shared URLs resume functioning according to the selected mode. ## Further reading {{< partial name="whats-next/whats-next.html" >}} -[1]: /dashboards/guide/datadog_clipboard/ -[2]: /api/latest/snapshots/ -[3]: https://app.datadoghq.com/organization-settings/public-sharing/settings +[1]: /api/latest/snapshots/ +[2]: https://app.datadoghq.com/organization-settings/public-sharing/settings diff --git a/content/en/dashboards/widgets/configuration/_index.md b/content/en/dashboards/widgets/configuration/_index.md index 2bb96dafeac..18ac5367830 100644 --- a/content/en/dashboards/widgets/configuration/_index.md +++ b/content/en/dashboards/widgets/configuration/_index.md @@ -112,7 +112,7 @@ Widgets not linked to global time show the data for their local time frame as ap Copy and paste functionality is a key sharing and collaboration feature that allows you to reuse widgets across different Datadog contexts and external tools. -
Enable Static Public Data Sharing in your Organization Settings to use this feature.
+
To copy widgets with Ctrl/Cmd + C, an admin must set Widget Share URLs to Public or Private in your Organization Settings. Admins can disable this setting to stop users from generating widget share links and previews.
Widgets can be copied on [Dashboards][4], [Notebooks][5], [APM Service][6], and the [APM resource][7] page by using Ctrl/Cmd + C, or by selecting the share icon and choosing "Copy". @@ -121,9 +121,7 @@ The copied widgets can be pasted within Datadog by using Ctrl/Cm * **Dashboards**: Adds a new widget positioned under your mouse cursor. * **Notebooks**: Adds a new cell at the end of the notebook. -You can also paste the widget into your favorite chat program that displays link previews (like Slack or Microsoft Teams). This displays a snapshot image of your graph along with a direct link to your widget. For more information, see [Widget Public URLs][11]. - -For information on copying widgets for use within Datadog (in dashboards, notebooks, and incidents), see [Datadog Clipboard][9]. +You can also paste the widget into your favorite chat program that displays link previews (like Slack or Microsoft Teams). Depending on your organization's Widget Share URLs mode, this displays a public preview image of your graph, or a private preview image in Slack, along with a direct link to your widget. For more information, see [Widget Share URLs][11]. ## Groups of widgets @@ -200,6 +198,5 @@ Click on the context menu (three vertical dots) of any dashboard graph to open a [6]: /tracing/services/service_page/ [7]: /tracing/services/resource_page/ [8]: /dashboards/guide/custom_time_frames/ -[9]: /dashboards/guide/datadog_clipboard/ [10]: /dashboards/widgets/split_graph/ -[11]: /dashboards/sharing/widget_public_urls/ \ No newline at end of file +[11]: /dashboards/sharing/widget_public_urls/