diff --git a/docs/devguide/metricset-details.asciidoc b/docs/devguide/metricset-details.asciidoc
index 933df9de3ed3..89f31c8d3246 100644
--- a/docs/devguide/metricset-details.asciidoc
+++ b/docs/devguide/metricset-details.asciidoc
@@ -106,7 +106,7 @@ include::../../metricbeat/module/mysql/_meta/fields.yml[]
 
 There is another `fields.yml` file under `module/{module}/{metricset}/_meta/fields.yml` that contains all fields retrieved
 by the metricset. As field types, each field must have a core data type
-https://www.elastic.co/guide/en/elasticsearch/reference/master/mapping-types.html#_core_datatypes[supported by elasticsearch]. Here's a very basic example that shows one group from the MySQL `status` metricset:
+{ref}/mapping-types.html#_core_datatypes[supported by elasticsearch]. Here's a very basic example that shows one group from the MySQL `status` metricset:
 
 [source,yaml]
 ----
diff --git a/metricbeat/module/elasticsearch/node/_meta/docs.asciidoc b/metricbeat/module/elasticsearch/node/_meta/docs.asciidoc
index 60af50238ebf..6e64f0cb0476 100644
--- a/metricbeat/module/elasticsearch/node/_meta/docs.asciidoc
+++ b/metricbeat/module/elasticsearch/node/_meta/docs.asciidoc
@@ -1,4 +1,4 @@
 The `node` metricset interrogates the
-https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-nodes-info.html[Cluster API endpoint] of
+{ref}/cluster-nodes-info.html[Cluster API endpoint] of
 Elasticsearch to get cluster nodes information. This metricset only fetches the data from the `_local` node so it must
 run on each Elasticsearch node.
diff --git a/metricbeat/module/elasticsearch/node_stats/_meta/docs.asciidoc b/metricbeat/module/elasticsearch/node_stats/_meta/docs.asciidoc
index e059f3187b14..e8adef480872 100644
--- a/metricbeat/module/elasticsearch/node_stats/_meta/docs.asciidoc
+++ b/metricbeat/module/elasticsearch/node_stats/_meta/docs.asciidoc
@@ -1,5 +1,5 @@
 The `node_stats` metricset interrogates the
-https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-nodes-stats.html[Cluster API endpoint] of
+{ref}/cluster-nodes-stats.html[Cluster API endpoint] of
 Elasticsearch to get the cluster nodes statistics. The data received is only for the local node so this Metricbeat has
 to be run on each Elasticsearch node.