diff --git a/guides/common/attributes-satellite.adoc b/guides/common/attributes-satellite.adoc
index fa869626c1e..f731cb9bf30 100644
--- a/guides/common/attributes-satellite.adoc
+++ b/guides/common/attributes-satellite.adoc
@@ -8,6 +8,10 @@
 :BaseURL: {RHDocsBaseURL}red_hat_satellite/{ProjectVersion}/html-single/
 
 // URLs (published on Red Hat Portal)
+// IMPORTANT: When you change any guide URLs, also update the following:
+// - guides/upstream_filename_to_satellite_link.json
+// - lib/foreman_theme_satellite/documentation.rb in RedHatSatellite/foreman_theme_satellite
+// - downstream_filename_to_link.json in downstream
 :AdministeringDocURL: {BaseURL}administering_red_hat_satellite/index#
 :ConfiguringLoadBalancerDocURL: {BaseURL}configuring_capsules_with_a_load_balancer/index#
 :ContentManagementDocURL: {BaseURL}managing_content/index#