diff --git a/docs/java-rest/high-level/migration.asciidoc b/docs/java-rest/high-level/migration.asciidoc
index 662df0f56403a..bfba3ce91dd67 100644
--- a/docs/java-rest/high-level/migration.asciidoc
+++ b/docs/java-rest/high-level/migration.asciidoc
@@ -45,6 +45,8 @@ The <<java-rest-high-getting-started,Getting Started>> page shows
  <<java-rest-high-getting-started-dependencies, dependencies>> brought by the
  high-level client.
 
+// This ID is bad but it is the one we've had forever.
+[[_changing_the_client_8217_s_initialization_code]]
 === Changing the client's initialization code
 
 The `TransportClient` is typically initialized as follows:
@@ -94,6 +96,8 @@ must be replaced with:
 include-tagged::{doc-tests}/MiscellaneousDocumentationIT.java[rest-high-level-client-close]
 --------------------------------------------------
 
+// This ID is bad but it is the one we've had forever.
+[[_changing_the_application_8217_s_code]]
 === Changing the application's code
 
 The `RestHighLevelClient` supports the same request and response objects