diff --git a/docs/sources/on-call-schedules/web-schedule/_index.md b/docs/sources/on-call-schedules/web-schedule/_index.md
index e29d7cad..d77104ef 100644
--- a/docs/sources/on-call-schedules/web-schedule/_index.md
+++ b/docs/sources/on-call-schedules/web-schedule/_index.md
@@ -51,7 +51,7 @@ on this calendar will take precedence over the rotations calendar.
 
 ## Schedule quality report
 
-The schedule view features a quality report that provides a score for your schedule based on rotations and overrides.
+The schedule view features a quality report that provides a score for your schedule based on rotations, overrides and [shift swaps][shift-swaps].
 It's calculated based on these key factors:
 
 - Gaps (amount of time when no one is on-call)
@@ -85,3 +85,8 @@ A perfectly balanced schedule is considered ideal, so reducing this number will
 
 Export on-call schedules from Grafana OnCall to your preferred calendar app with a one-time secret iCal URL. The
 schedule export allows you to view on-call shifts alongside the rest of your schedule.
+
+{{% docs/reference %}}
+[shift-swaps]: "/docs/oncall/ -> /docs/oncall/<ONCALL VERSION>/on-call-schedules/shift-swaps"
+[shift-swaps]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/oncall/on-call-schedules/shift-swaps"
+{{% /docs/reference %}}