diff --git a/docs/en/rest-api/migration/deprecation.asciidoc b/docs/en/rest-api/migration/deprecation.asciidoc
index 4540d0cdec4..8402e77e5bf 100644
--- a/docs/en/rest-api/migration/deprecation.asciidoc
+++ b/docs/en/rest-api/migration/deprecation.asciidoc
@@ -24,7 +24,7 @@ Example response:
     {
       "level" : "info",
       "message" : "Network settings changes",
-      "url" : "{ref}/breaking_60_indices_changes.html#_index_templates_use_literal_index_patterns_literal_instead_of_literal_template_literal",
+      "url" : "{ref-60}/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" : "{ref}/breaking_60_mappings_changes.html#_coercion_of_boolean_fields",
+        "url" : "{ref-60}/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]]"
       }
     ]
@@ -53,7 +53,7 @@ The following is an example deprecation warning:
 {
   "level" : "info",
   "message" : "This is the generic descriptive message of the breaking change",
-  "url" : "{ref}/breaking_60_indices_changes.html",
+  "url" : "{ref-60}/breaking_60_indices_changes.html",
   "details" : "more information, like which nodes, indices, or settings are to blame"
 }
 --------------------------------------------------