Cannot Create an Okta Custom Domain Ending in okta.com
Last Updated:
Overview
Administrators cannot create a custom domain that ends in .okta.com because Okta owns and manages the okta.com root domain, requiring administrators to configure a domain they own and prove ownership via public Domain Name System (DNS) records. When attempting to configure a custom domain, creating a subdomain under .okta.com is not possible.
Applies To
- Okta Identity Engine (OIE)
- Okta Classic Engine
- Custom Domain
- Standard Subdomain
Cause
Configuring a custom domain in Okta requires proving ownership of the root domain by modifying its public DNS records. Because Okta owns and manages the okta.com root domain, administrators do not have administrative access to create new subdomains or modify DNS records under it.
Solution
How is a custom domain configured in Okta?
Add a custom domain by navigating to the Brands section in the Admin Console, entering a custom subdomain name, and selecting the Okta-managed certificate option.
- Sign in to the Okta Admin Console with a Super Administrator account.
- Go to Customizations > Brands.
- Select the brand to update.
- Choose the Domains tab, and then select Add domain in the Custom domain section.
- Enter the custom subdomain name (for example,
<example.domainName.com>). - Select Okta-managed for an easier and faster certificate setup, and then choose Next.
- Verify the domain.
