diff --git a/docs/polis/_assets/sso/box-1.png b/docs/polis/_assets/sso/box-1.png
new file mode 100644
index 000000000..c3c4fe077
Binary files /dev/null and b/docs/polis/_assets/sso/box-1.png differ
diff --git a/docs/polis/_assets/sso/dropbox-1.png b/docs/polis/_assets/sso/dropbox-1.png
new file mode 100644
index 000000000..942018eef
Binary files /dev/null and b/docs/polis/_assets/sso/dropbox-1.png differ
diff --git a/docs/polis/_assets/sso/dropbox-2.png b/docs/polis/_assets/sso/dropbox-2.png
new file mode 100644
index 000000000..5814922ae
Binary files /dev/null and b/docs/polis/_assets/sso/dropbox-2.png differ
diff --git a/docs/polis/_assets/sso/freshchat-1.png b/docs/polis/_assets/sso/freshchat-1.png
new file mode 100644
index 000000000..b9e656226
Binary files /dev/null and b/docs/polis/_assets/sso/freshchat-1.png differ
diff --git a/docs/polis/_assets/sso/freshchat-2.png b/docs/polis/_assets/sso/freshchat-2.png
new file mode 100644
index 000000000..4156c45c5
Binary files /dev/null and b/docs/polis/_assets/sso/freshchat-2.png differ
diff --git a/docs/polis/_assets/sso/postman-1.png b/docs/polis/_assets/sso/postman-1.png
new file mode 100644
index 000000000..59fe2f991
Binary files /dev/null and b/docs/polis/_assets/sso/postman-1.png differ
diff --git a/docs/polis/_assets/sso/postman-2.png b/docs/polis/_assets/sso/postman-2.png
new file mode 100644
index 000000000..1489ef817
Binary files /dev/null and b/docs/polis/_assets/sso/postman-2.png differ
diff --git a/docs/polis/_assets/sso/sentry-metadata.png b/docs/polis/_assets/sso/sentry-metadata.png
new file mode 100644
index 000000000..caded3704
Binary files /dev/null and b/docs/polis/_assets/sso/sentry-metadata.png differ
diff --git a/docs/polis/guides/configuring-saml-sso.mdx b/docs/polis/guides/configuring-saml-sso.mdx
index f290c50c3..ce74658bb 100644
--- a/docs/polis/guides/configuring-saml-sso.mdx
+++ b/docs/polis/guides/configuring-saml-sso.mdx
@@ -46,9 +46,7 @@ the **Security** tab.
 
 Here is how Sentry does the SAML SSO configuration for their customers.
 
-<p>
-  <img src="/images/guides/sso/sentry-metadata.png" style={{ border: "1px solid black" }} title="The SAML SSO settings" />
-</p>
+![The SAML SSO settings](../_assets/sso/sentry-metadata.png)
 
 To create an [SSO connection with Ory Polis](../sso-flow/#2-sso-connection-api), you must pass the tenant identifier, product
 name, and XML metadata. So your settings page UI must display a form to capture the XML Metadata.
diff --git a/docs/polis/guides/login-with-saml-sso.mdx b/docs/polis/guides/login-with-saml-sso.mdx
index b7b6d03fc..1215b5068 100644
--- a/docs/polis/guides/login-with-saml-sso.mdx
+++ b/docs/polis/guides/login-with-saml-sso.mdx
@@ -24,9 +24,9 @@ they click the button.
 
 **Postman** takes this approach to enable SAML SSO for their enterprise users.
 
-<img src="/images/guides/sso/postman-1.png" style={{ border: "1px solid black" }} />
+![Postman Login 1](../_assets/sso/postman-1.png)
 
-<img src="/images/guides/sso/postman-2.png" style={{ border: "1px solid black" }} />
+![Postman Login 2](../_assets/sso/postman-2.png)
 
 The user flow would be something similar to the one below.
 
@@ -43,9 +43,9 @@ This approach hides the password field if SSO is enabled for a domain.
 
 You can see this approach on the **Dropbox** login form.
 
-<img src="/images/guides/sso/dropbox-1.png" style={{ border: "1px solid black" }} />
+![Dropbox Login 1](../_assets/sso/dropbox-1.png)
 
-<img src="/images/guides/sso/dropbox-2.png" style={{ border: "1px solid black" }} />
+![Dropbox Login 2](../_assets/sso/dropbox-2.png)
 
 The user flow would be something similar to the one below.
 
@@ -63,11 +63,9 @@ application redirects users to the subdomain page to show the available authenti
 
 You can see this approach on the **Freshchat or Freshworks** login form.
 
-<img src="/images/guides/sso/freshchat-1.png" style={{ border: "1px solid black" }} />
+![Freshchat Login 1](../_assets/sso/freshchat-1.png)
 
-<p align="center">
-  <img src="/images/guides/sso/freshchat-2.png" width="70%" style={{ border: "1px solid black" }} />
-</p>
+![Freshchat Login 2](../_assets/sso/freshchat-2.png)
 
 The user flow would be something similar to the one below.
 
@@ -85,7 +83,7 @@ the current user.
 
 **Box** uses this approach for its authentication flow.
 
-<img src="/images/guides/sso/box-1.png" style={{ border: "1px solid black" }} />
+![Box Login](../_assets/sso/box-1.png)
 
 The user flow would be something similar to the one below.