diff --git a/docs/reference/glossary.asciidoc b/docs/reference/glossary.asciidoc
index e13b5812f7b..63d0a43a8bf 100644
--- a/docs/reference/glossary.asciidoc
+++ b/docs/reference/glossary.asciidoc
@@ -100,11 +100,15 @@ An index is a logical namespace which maps to one or more
 +
 --
 // tag::index-alias-def[]
+// tag::index-alias-desc[]
 An index alias is a secondary name
 used to refer to one or more existing indices.
 
 Most {es} APIs accept an index alias
 in place of an index name.
+// end::index-alias-desc[]
+
+See {ref}/indices-add-alias.html[Add index alias].
 // end::index-alias-def[]
 
 See <<indices-add-alias>>.
diff --git a/docs/reference/indices/add-alias.asciidoc b/docs/reference/indices/add-alias.asciidoc
index 427ddf631ce..c1f75bdb2dd 100644
--- a/docs/reference/indices/add-alias.asciidoc
+++ b/docs/reference/indices/add-alias.asciidoc
@@ -6,7 +6,7 @@
 
 Creates or updates an index alias.
 
-include::{docdir}/glossary.asciidoc[tag=index-alias-def]
+include::{docdir}/glossary.asciidoc[tag=index-alias-desc]
 
 [source,console]
 ----
diff --git a/docs/reference/indices/alias-exists.asciidoc b/docs/reference/indices/alias-exists.asciidoc
index 8caa3080fee..ed38e44edc2 100644
--- a/docs/reference/indices/alias-exists.asciidoc
+++ b/docs/reference/indices/alias-exists.asciidoc
@@ -6,7 +6,7 @@
 
 Checks if an index alias exists.
 
-include::{docdir}/glossary.asciidoc[tag=index-alias-def]
+include::{docdir}/glossary.asciidoc[tag=index-alias-desc]
 
 [source,console]
 ----
diff --git a/docs/reference/indices/aliases.asciidoc b/docs/reference/indices/aliases.asciidoc
index 991b65b0793..1172f9cf4d1 100644
--- a/docs/reference/indices/aliases.asciidoc
+++ b/docs/reference/indices/aliases.asciidoc
@@ -6,7 +6,7 @@
 
 Adds or removes index aliases.
 
-include::{docdir}/glossary.asciidoc[tag=index-alias-def]
+include::{docdir}/glossary.asciidoc[tag=index-alias-desc]
 
 [source,console]
 ----
diff --git a/docs/reference/indices/delete-alias.asciidoc b/docs/reference/indices/delete-alias.asciidoc
index 4ab144a2fd6..3a3eed4b80a 100644
--- a/docs/reference/indices/delete-alias.asciidoc
+++ b/docs/reference/indices/delete-alias.asciidoc
@@ -6,7 +6,7 @@
 
 Deletes an existing index alias.
 
-include::{docdir}/glossary.asciidoc[tag=index-alias-def]
+include::{docdir}/glossary.asciidoc[tag=index-alias-desc]
 
 [source,console]
 ----
diff --git a/docs/reference/indices/get-alias.asciidoc b/docs/reference/indices/get-alias.asciidoc
index 8b25e3c21ac..0f2c4e88e56 100644
--- a/docs/reference/indices/get-alias.asciidoc
+++ b/docs/reference/indices/get-alias.asciidoc
@@ -6,7 +6,7 @@
 
 Returns information about one or more index aliases.
 
-include::{docdir}/glossary.asciidoc[tag=index-alias-def]
+include::{docdir}/glossary.asciidoc[tag=index-alias-desc]
 
 [source,console]
 ----