diff --git a/docs/auth/auth-saml-azure.rst b/docs/auth/auth-saml-azure.rst
index 2df03ed0..1880e408 100644
--- a/docs/auth/auth-saml-azure.rst
+++ b/docs/auth/auth-saml-azure.rst
@@ -158,4 +158,24 @@ Below is an example attribute mapping set for IDP provider required by the above
 
 .. image:: ../images/saml-azure-attributes-example.png
    :alt: Azure SAML setup example
+   :scale: 50 %
+
+
+Example Configuration with Email as Common ID
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Here's an example configuration where email is used as the common identifier (unique user identifier).
+
+In this configuration, the NameID claim is set to use email address format, and the unique 
+identifier is mapped to the user's email (user.userprincipalname in Azure):
+
+.. image:: ../images/unique-id-claim.png
+   :alt: Azure unique ID claim configuration with email
+   :scale: 50 %
+
+The corresponding attributes and claims configuration shows how to map the required user 
+attributes for RhodeCode integration:
+
+.. image:: ../images/azure-attrs-claims.png
+   :alt: Azure attributes and claims configuration
    :scale: 50 %
\ No newline at end of file
diff --git a/docs/images/azure-attrs-claims.png b/docs/images/azure-attrs-claims.png
new file mode 100644
index 00000000..1fb20939
Binary files /dev/null and b/docs/images/azure-attrs-claims.png differ
diff --git a/docs/images/unique-id-claim.png b/docs/images/unique-id-claim.png
new file mode 100644
index 00000000..b6adf3e5
Binary files /dev/null and b/docs/images/unique-id-claim.png differ