diff --git a/docs/docs/guides/integrate/identity-providers/mocksaml.mdx b/docs/docs/guides/integrate/identity-providers/mocksaml.mdx
new file mode 100644
index 000000000..8b9bd426f
--- /dev/null
+++ b/docs/docs/guides/integrate/identity-providers/mocksaml.mdx
@@ -0,0 +1,65 @@
+---
+title: Configure MockSAML as an Identity Provider in ZITADEL
+sidebar_label: MockSAML
+id: mocksaml
+---
+
+import GeneralConfigDescription from './_general_config_description.mdx';
+import Intro from './_intro.mdx';
+import CustomLoginPolicy from './_custom_login_policy.mdx';
+import IDPsOverview from './_idps_overview.mdx';
+import Activate from './_activate.mdx';
+import TestSetup from './_test_setup.mdx';
+
+
+
+:::warning
+MockSAML is not intended for any production environment, only for test purposes
+:::
+
+## MockSAML
+
+### Download metadata
+
+You can either download the metadata under [https://mocksaml.com/api/saml/metadata?download=true](https://mocksaml.com/api/saml/metadata?download=true) or skip this step and
+fill in the URL when creating the SAML SP in ZITADEL.
+
+## ZITADEL configuration
+
+### Add custom login policy
+
+
+
+### Go to the IdP providers overview
+
+
+
+### Create a new SAML ServiceProvider
+
+The SAML SP provider template has everything you need preconfigured.
+Add the metadata.xml or the URL to the metadata which are accessible by you ZITADEL instance.
+All the necessary configuration is contained in the metadata which has to be exchanged by the ServiceProvider and the IdentityProvider.
+
+
+
+
+
+### Download metadata
+
+Normally, you would need to download the ServiceProvider metadata from ZITADEL to upload to the IdentityProvider.
+They are available under [https://{CUSTOMDOMAIN}/idps/{ID of the provider in ZITADEL}/saml/metadata], but this step can be skipped due to the fact that MockSAML is only for testing purposes.
+
+### Activate IdP
+
+
+
+
+
+## Test the setup
+
+
+
+
+
+
+
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 5e9c5ea27..1cc318d6b 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -293,6 +293,7 @@ module.exports = {
"guides/integrate/identity-providers/migrate",
"guides/integrate/identity-providers/okta",
"guides/integrate/identity-providers/keycloak",
+ "guides/integrate/identity-providers/mocksaml",
"guides/integrate/identity-providers/additional-information",
],
},
diff --git a/docs/static/img/guides/mocksaml_login.png b/docs/static/img/guides/mocksaml_login.png
new file mode 100644
index 000000000..364d01820
Binary files /dev/null and b/docs/static/img/guides/mocksaml_login.png differ
diff --git a/docs/static/img/guides/zitadel_activate_saml.png b/docs/static/img/guides/zitadel_activate_saml.png
new file mode 100644
index 000000000..a7019e40a
Binary files /dev/null and b/docs/static/img/guides/zitadel_activate_saml.png differ
diff --git a/docs/static/img/guides/zitadel_login_saml.png b/docs/static/img/guides/zitadel_login_saml.png
new file mode 100644
index 000000000..70399ae89
Binary files /dev/null and b/docs/static/img/guides/zitadel_login_saml.png differ
diff --git a/docs/static/img/guides/zitadel_saml_create_provider.png b/docs/static/img/guides/zitadel_saml_create_provider.png
new file mode 100644
index 000000000..1a6ec312d
Binary files /dev/null and b/docs/static/img/guides/zitadel_saml_create_provider.png differ