diff --git a/src/docs/product/dashboards/widget-builder/index.mdx b/src/docs/product/dashboards/widget-builder/index.mdx
index 3ddf1abcb19d7..1c84e6ea0faab 100644
--- a/src/docs/product/dashboards/widget-builder/index.mdx
+++ b/src/docs/product/dashboards/widget-builder/index.mdx
@@ -125,3 +125,10 @@ The option to sort by a y-axis is only available if you've applied a grouping to
 If you select “Custom Equation”, an extra field appears where you can enter an equation of your choice that will be applied to the query:
 
 ![Custom equation field.](widget-builder-custom-equation-field.png)
+
+## Set Thresholds
+
+The option for setting thresholds is only available for [big number visualizations](/product/dashboards/widget-builder/#big-number). Thresholds help identify problematic widgets with colored indicators. Hovering over the colored indicators at the dashboard level displays the thresholds associated with a widget. Units can be attached to thresholds for duration or rate metric types. An example metric with units would be “p95 of all transactions”.
+
+![Set Thresholds Step](widget-builder-thresholds.png)
+![Widget Coloured Indicator Hover](widget-builder-thresholds-hover.png)
diff --git a/src/docs/product/dashboards/widget-builder/widget-builder-thresholds-hover.png b/src/docs/product/dashboards/widget-builder/widget-builder-thresholds-hover.png
new file mode 100644
index 0000000000000..cbff7212de3d2
Binary files /dev/null and b/src/docs/product/dashboards/widget-builder/widget-builder-thresholds-hover.png differ
diff --git a/src/docs/product/dashboards/widget-builder/widget-builder-thresholds.png b/src/docs/product/dashboards/widget-builder/widget-builder-thresholds.png
new file mode 100644
index 0000000000000..b66f1a0f0c838
Binary files /dev/null and b/src/docs/product/dashboards/widget-builder/widget-builder-thresholds.png differ