diff --git a/docs/connecting.asciidoc b/docs/connecting.asciidoc
index acfbe120f..03bc4532d 100644
--- a/docs/connecting.asciidoc
+++ b/docs/connecting.asciidoc
@@ -61,11 +61,11 @@ const client = new Client({
 ==== ApiKey authentication
 
 You can use the 
-https://www.elastic.co/guide/en/elasticsearch/reference/7.x/security-api-create-api-key.html[ApiKey] 
+{ref-7x}/security-api-create-api-key.html[ApiKey] 
 authentication by passing the `apiKey` parameter via the `auth` option. The 
 `apiKey` parameter can be either a base64 encoded string or an object with the 
 values that you can obtain from the 
-https://www.elastic.co/guide/en/elasticsearch/reference/7.x/security-api-create-api-key.html[create api key endpoint].
+{ref-7x}/security-api-create-api-key.html[create api key endpoint].
 
 NOTE: If you provide both basic authentication credentials and the ApiKey 
 configuration, the ApiKey takes precedence.