diff --git a/docs/en/rest-api/migration/deprecation.asciidoc b/docs/en/rest-api/migration/deprecation.asciidoc
index 6aefb836333..4540d0cdec4 100644
--- a/docs/en/rest-api/migration/deprecation.asciidoc
+++ b/docs/en/rest-api/migration/deprecation.asciidoc
@@ -17,14 +17,14 @@ GET /_xpack/migration/deprecations
 Example response:
 
 
-[source,js]
+["source","js",subs="attributes,callouts,macros"]
 --------------------------------------------------
 {
   "cluster_settings" : [
     {
       "level" : "info",
       "message" : "Network settings changes",
-      "url" : "https://www.elastic.co/guide/en/elasticsearch/reference/master/breaking_60_indices_changes.html#_index_templates_use_literal_index_patterns_literal_instead_of_literal_template_literal",
+      "url" : "{ref}/breaking_60_indices_changes.html#_index_templates_use_literal_index_patterns_literal_instead_of_literal_template_literal",
       "details" : "templates using `template` field: watches,.monitoring-alerts,.watch-history-6,.ml-notifications,security-index-template,triggered_watches,.monitoring-es,.ml-meta,.ml-state,.monitoring-logstash,.ml-anomalies-,.monitoring-kibana"
     }
   ],
@@ -34,7 +34,7 @@ Example response:
       {
         "level" : "info",
         "message" : "Coercion of boolean fields",
-        "url" : "https://www.elastic.co/guide/en/elasticsearch/reference/master/breaking_60_mappings_changes.html#_coercion_of_boolean_fields",
+        "url" : "{ref}/breaking_60_mappings_changes.html#_coercion_of_boolean_fields",
         "details" : "[[type: doc, field: spins], [type: doc, field: mlockall], [type: doc, field: node_master], [type: doc, field: primary]]"
       }
     ]
@@ -48,12 +48,12 @@ cluster should resolve before upgrading. Any offending setting will be represent
 
 The following is an example deprecation warning:
 
-[source,js]
+["source","js",subs="attributes,callouts,macros"]
 --------------------------------------------------
 {
   "level" : "info",
   "message" : "This is the generic descriptive message of the breaking change",
-  "url" : "https://www.elastic.co/guide/en/elasticsearch/reference/master/breaking_60_indices_changes.html",
+  "url" : "{ref}/breaking_60_indices_changes.html",
   "details" : "more information, like which nodes, indices, or settings are to blame"
 }
 --------------------------------------------------