diff --git a/docs/devguide/metricset-details.asciidoc b/docs/devguide/metricset-details.asciidoc
index 126454a55d1..38e4b75eed7 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 3003d7538fc..00c80954e85 100644
--- a/metricbeat/module/elasticsearch/node/_meta/docs.asciidoc
+++ b/metricbeat/module/elasticsearch/node/_meta/docs.asciidoc
@@ -1,6 +1,6 @@
 === Elasticsearch node metricset
 
 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 33bea6ebbd4..d2a5dbc986f 100644
--- a/metricbeat/module/elasticsearch/node_stats/_meta/docs.asciidoc
+++ b/metricbeat/module/elasticsearch/node_stats/_meta/docs.asciidoc
@@ -1,7 +1,7 @@
 === Elasticsearch node_stats metricset
 
 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.