diff --git a/docs/sources/shared/visualizations/datalink-options-1.md b/docs/sources/shared/visualizations/datalink-options-1.md
index 5cfe706abf6..8ee5051089e 100644
--- a/docs/sources/shared/visualizations/datalink-options-1.md
+++ b/docs/sources/shared/visualizations/datalink-options-1.md
@@ -1,6 +1,8 @@
 ---
 title: Data links and actions options
 comments: |
+  There are four data link shared files, datalink-options.md, datalink-options-1.md, datalink-options-2.md, and datalink-options-3.md to cover the most common combinations of options. 
+  Using shared files ensures that content remains consistent across visualizations that share the same options and users don't have to figure out which options apply to a specific visualization when reading that content.
   This file is used in the following visualizations: bar gauge, gauge, pie chart, stat
 ---
 
diff --git a/docs/sources/shared/visualizations/datalink-options-2.md b/docs/sources/shared/visualizations/datalink-options-2.md
index b74b753b4e6..278f7033216 100644
--- a/docs/sources/shared/visualizations/datalink-options-2.md
+++ b/docs/sources/shared/visualizations/datalink-options-2.md
@@ -1,6 +1,8 @@
 ---
 title: Data links and actions options
 comments: |
+  There are four data link shared files, datalink-options.md, datalink-options-1.md, datalink-options-2.md, and datalink-options-3.md to cover the most common combinations of options. 
+  Using shared files ensures that content remains consistent across visualizations that share the same options and users don't have to figure out which options apply to a specific visualization when reading that content.
   This file is used in the following visualizations: bar chart, candlestick, state timeline, status history, time series, trend, xy chart
 ---
 
diff --git a/docs/sources/shared/visualizations/datalink-options-3.md b/docs/sources/shared/visualizations/datalink-options-3.md
index 738a5898596..5618a80f306 100644
--- a/docs/sources/shared/visualizations/datalink-options-3.md
+++ b/docs/sources/shared/visualizations/datalink-options-3.md
@@ -1,6 +1,8 @@
 ---
 title: Data links and actions options
 comments: |
+  There are four data link shared files, datalink-options.md, datalink-options-1.md, datalink-options-2.md, and datalink-options-3.md to cover the most common combinations of options. 
+  Using shared files ensures that content remains consistent across visualizations that share the same options and users don't have to figure out which options apply to a specific visualization when reading that content.  
   This file is used in the following visualizations: table
 ---
 
diff --git a/docs/sources/shared/visualizations/datalink-options.md b/docs/sources/shared/visualizations/datalink-options.md
index 131640d86ee..28c6afad0e3 100644
--- a/docs/sources/shared/visualizations/datalink-options.md
+++ b/docs/sources/shared/visualizations/datalink-options.md
@@ -1,6 +1,8 @@
 ---
 title: Data links and actions options
 comments: |
+  There are four data link shared files, datalink-options.md, datalink-options-1.md, datalink-options-2.md, and datalink-options-3.md to cover the most common combinations of options. 
+  Using shared files ensures that content remains consistent across visualizations that share the same options and users don't have to figure out which options apply to a specific visualization when reading that content.
   This file is used in the following visualizations: geomap, heatmap, histogram
 ---