Alerts can be shared via a shareable URL

docs/detections/alerts-view-details.asciidoc

@@ -1,10 +1,10 @@
 [[view-alert-details]]
 == View detection alert details
 
-To inspect a detection alert, click the *View details* button from the Alerts table. The alert details flyout appears with several options to view alert data.
+To inspect a detection alert, click the *View details* button from the Alerts table. The alert details flyout appears with a way to share the alert and several options to view alert data.
 
 [role="screenshot"]
-image::images/view-alert-details.png[View details button, 200]
+image::images/view-alert-details.png[View details button, 200] 
 
 The alert details flyout contains these informational tabs:
 
@@ -14,6 +14,12 @@ The alert details flyout contains these informational tabs:
 * *JSON*: The alert data in JSON format.
 * *Osquery Results*: Results from queries attached to rules display on the *Osquery Results* tab. <<add-osquery-response-action,Learn more.>>
 
+The **Share alert** link gives you a direct way to share alert details. Click the link to get a shareable URL that you can paste into browsers, cases, messages, and more. Do _not_ use the general browser URL to share the alert. It can cause inconsistent results if the Alerts page has filters or relative time ranges. 
+
+IMPORTANT: If you've enabled grouping on the Alerts page, the alert details flyout won't open until you expand the collapsed group. 
+
+NOTE: If you've set the {kibana-ref}/settings.html#server-publicBaseUrl[`server.publicBaseUrl`] configuration setting in the `kibana.yml` file, you can also find the shareable URL in the `kibana.alert.url` field. You can find the field by going the *Table* tab and searching for `kibana.alert.url`.
+
 [role="screenshot"]
 image::images/alert-details-flyout.png[Alert details flyout, 90%]
 

docs/reference/alert-schema.asciidoc

@@ -156,5 +156,11 @@ Type: date
 Type: date
 |N/A | `kibana.alert.suppression.docs_count` | The number of suppressed alerts.
 
+Type: long
+
+|N/A | `kibana.alert.url` a| The shareable URL for the alert.
+
+NOTE: This field only appears if you've set the {kibana-ref}/settings.html#server-publicBaseUrl[`server.publicBaseUrl`] configuration setting in the `kibana.yml` file. 
+
 Type: long
 |==============================================