Update Widget Share URLs docs (#37473)

* Update Widget Share URLs docs

* Restore Datadog Clipboard distinction in Widget Share URLs note

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Incorporate rtrieu and chatgpt-codex-connector's feedback

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: Jiawen23

config/_default/menus/main.en.yaml

@@ -1762,24 +1762,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

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" >}}<strong>Shared dashboards</strong>: Generate a public link for users to access{{< /nextlink >}}
    {{< nextlink href="dashboards/sharing/graphs" >}}<strong>Share graphs</strong>: Generate an embed code{{< /nextlink >}}
-   {{< nextlink href="dashboards/sharing/widget_public_urls" >}}<strong>Widget Public URLs</strong>: Copy widgets as images to share outside of Datadog{{< /nextlink >}}
+   {{< nextlink href="dashboards/sharing/widget_public_urls" >}}<strong>Widget Share URLs</strong>: Copy widgets as images to share outside of Datadog{{< /nextlink >}}
    {{< nextlink href="dashboards/sharing/scheduled_reports" >}}<strong>Scheduled reports</strong>: Set a schedule to send email reports{{< /nextlink >}}
 {{< /whatsnext >}}
 

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,27 +12,35 @@ 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 <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>C</kbd>, 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 <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>C</kbd>, 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**][3]:
+
+| 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 [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.
 
 ## 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 <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>C</kbd>, or click the share icon and select **Copy**.
 3. Paste outside of Datadog using <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>V</kbd>.
 
-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**][3]. 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
 

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.
 
-<div class="alert alert-danger">Enable <a href="https://app.datadoghq.com/organization-settings/public-sharing/settings"><strong>Static Public Data Sharing</strong></a> in your Organization Settings to use this feature.</div>
+<div class="alert alert-info">To share widgets outside of Datadog with link previews, an admin must set <a href="https://app.datadoghq.com/organization-settings/public-sharing/settings"><strong>Widget Share URLs</strong></a> to Public or Private in your Organization Settings. Admins can disable this setting to stop users from generating widget share links and previews.</div>
 
 Widgets can be copied on [Dashboards][4], [Notebooks][5], [APM Service][6], and the [APM resource][7] page by using <kbd>Ctrl</kbd>/<kbd>Cmd</kbd> + <kbd>C</kbd>, or by selecting the share icon and choosing "Copy".
 
@@ -121,9 +121,7 @@ The copied widgets can be pasted within Datadog by using <kbd>Ctrl</kbd>/<kbd>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/
+[11]: /dashboards/sharing/widget_public_urls/