diff --git a/api-ref/source/v3-ext/index.rst b/api-ref/source/v3-ext/index.rst
index dd1c44c2cb..e2634c87e2 100644
--- a/api-ref/source/v3-ext/index.rst
+++ b/api-ref/source/v3-ext/index.rst
@@ -4,6 +4,20 @@
  Identity API v3 extensions (CURRENT)
 --------------------------------------
 
+=============
+Relationships
+=============
+
+The entries within the operations below contain a relationship link, which
+appears as a valid URI, however these are actually
+URN (Uniform Resource Name), which are similar to GUID except it uses a URI
+syntax so that it is easier to be read. These links do not resolve to
+anything valid, but exist to show a relationship.
+
+=======================
+Identity API Extensions
+=======================
+
 This page describes these Identity API v3 extensions:
 
 * `OS-ENDPOINT-POLICY API`_
diff --git a/api-ref/source/v3/index.rst b/api-ref/source/v3/index.rst
index 96693805cf..2e4a48efa9 100644
--- a/api-ref/source/v3/index.rst
+++ b/api-ref/source/v3/index.rst
@@ -154,6 +154,19 @@ These features are considered stable as of February 20, 2013.
 - Partial updates are performed using the HTTP ``PATCH`` method
 - Token ID values no longer appear in URLs
 
+=============
+Relationships
+=============
+
+The entries within the operations below contain a relationship link, which
+appears as a valid URI, however these are actually
+URN (Uniform Resource Name), which are similar to GUID except it uses a URI
+syntax so that it is easier to be read. These links do not resolve to
+anything valid, but exist to show a relationship.
+
+=======================
+Identity API Operations
+=======================
 
 This page lists the Identity API operations in the following order: