Changing Okta Metadata URL Between Custom and Default Domains
May 16, 2025
Single Sign-On
Okta Classic Engine
Okta Identity Engine
Overview
This article describes how to update the Okta metadata URL used for SAML integrations to switch between an Okta default domain and a custom domain, and vice versa.
- Default Domain Example:
https://<okta-subdomain>.okta.com/app/<application-id>/sso/saml/metadata - Custom Domain Example:
https://<custom-domain>/app/<application-id>/sso/saml/metadata
Applies To
- Single Sign-On
- Metadata URL
Solution
Construct the new metadata URL by replacing the domain portion:
- To switch to a custom domain, replace the default Okta subdomain (example.okta.com) with the custom domain (example.com).
- To switch to the default domain, replace the custom domain with the Okta default subdomain.
Example (Switching to Custom):
Current: https://<okta-subdomain>/app/<application-id>/sso/saml/metadata
Target: https://<custom-domain>/app/<application-id>/sso/saml/metadata
Example (Switching to Default):
Current: https://<custom-domain>/app/<application-id>/sso/saml/metadata
Target: https://<okta-subdomain>/app/<application-id>/sso/saml/metadata
