diff --git a/docs/kratos/organizations/_static/onboarding-portal-link-mappers.png b/docs/kratos/organizations/_static/onboarding-portal-link-mappers.png
new file mode 100644
index 0000000000..6a86f517da
Binary files /dev/null and b/docs/kratos/organizations/_static/onboarding-portal-link-mappers.png differ
diff --git a/docs/kratos/organizations/organizations.mdx b/docs/kratos/organizations/organizations.mdx
index 0167e0b9a8..d4294faaff 100644
--- a/docs/kratos/organizations/organizations.mdx
+++ b/docs/kratos/organizations/organizations.mdx
@@ -450,6 +450,16 @@ import BrowserWindow from "@site/src/theme/BrowserWindow"
 </BrowserWindow>
 ```
 
+##### Configure provider-specific data mappings
+
+Data mappers can be configured per provider in the Onboarding Portal. When creating an onboarding portal, admins can select an SSO
+or SCIM provider and define a dedicated data mapping for that provider, enabling precise control over how claims and directory
+attributes are mapped to identity traits.
+
+<BrowserWindow url="https://console.ory.sh/projects/<id>/authentication/organizations/<id>/edit">
+  ![Onboarding portal link](./_static/onboarding-portal-link-mappers.png)
+</BrowserWindow>
+
 ```mdx-code-block
 </TabItem>
 <TabItem value="api" label="API">
@@ -470,7 +480,8 @@ curl -X POST --location "https://api.console.ory.sh/projects/$PROJECT_ID/organiz
            "expires_at": "2025-06-01T00:00:00Z",
            "enable_sso": true,
            "enable_scim": true,
-           "custom_hostname_id": "use a custom domain id from branding, omit the field otherwise"
+           "custom_hostname_id": "use a custom domain id from branding, omit the field otherwise",
+           "saml_mapper_url": "base64://{BASE64_ENCODED_JSONNET}"
          }'
 ```