diff --git a/src/content/docs/build/domains/pointing-your-domain.mdx b/src/content/docs/build/domains/pointing-your-domain.mdx index 74d9ba814..69895b7e2 100644 --- a/src/content/docs/build/domains/pointing-your-domain.mdx +++ b/src/content/docs/build/domains/pointing-your-domain.mdx @@ -1,9 +1,12 @@ --- page_id: f0bc688b-a817-42ab-9a20-8e09cec06f37 -title: Use your own custom domain +title: Use a custom domain with Kinde description: Complete guide for setting up custom domains in Kinde including DNS configuration, verification process, SSL certificate provisioning, and integration with social authentication providers. sidebar: order: 1 + label: Use a custom domain +tableOfContents: + maxHeadingLevel: 3 relatedArticles: - 1dc6ae8d-b294-468c-a2ae-ceae7261decb - b3081ca1-2aa1-45e3-a42f-5295aac49bc3 @@ -16,6 +19,9 @@ topics: - domains - custom-domain - dns + - ssl + - caa-records + - social-sign-in sdk: [] languages: [] audience: developers @@ -29,55 +35,95 @@ keywords: - social auth - domain verification - multi-level subdomains -updated: 2024-01-15 + - CAA records + - ZeroSSL + - Let's Encrypt + - first-party cookie + - auth endpoint + - domain provisioning + - KINDE_ISSUER_URL +updated: 2026-05-13 featured: false deprecated: false -ai_summary: Complete guide for setting up custom domains in Kinde including DNS configuration, verification process, SSL certificate provisioning, and integration with social authentication providers. +ai_summary: "This guide explains how to configure a custom domain for your Kinde business. It covers the full setup: adding your custom domain in the Kinde dashboard, creating CNAME DNS records with your domain provider, and monitoring the verification and SSL provisioning process. Advanced topics include configuring CAA records to authorize both ZeroSSL (sectigo.com) and Let's Encrypt for certificate issuance, adding the custom domain to social sign-in provider apps so the sign-in form reflects your brand, and handling multi-level subdomains that require additional DNS entries. Troubleshooting guidance covers common DNS formatting tips, how to confirm the custom domain appears in your application's App keys, and how to update environment variables such as KINDE_ISSUER_URL to point to the custom domain. The FAQ section addresses provisioning time (5 minutes to a few hours), the benefits of using a custom domain (seamless user experience, first-party cookies for SPAs, branding), when to keep using the Kinde domain (Management API and machine-to-machine apps), why the challenge DNS record must stay after verification for SSL renewal, and local domain support limitations." --- -By default, Kinde issues a Kinde subdomain when you first register. But for your production environment you can use your own custom domain instead of Kinde’s as your URL. For example, `account.example.com` instead of `mydomain.kinde.com`. +Use a custom domain with Kinde and add trust to your users. Follow the steps below: -There are a few reasons you may wish to do this. +### What you need -- It will give your users the impression they have never left your application to authenticate, creating a seamless user experience. -- For Single Page Applications (SPAs) it means we can securely set a first party cookie meaning authentication state persists for full-page refreshes and new tabs. -- If you also register the domain in the configuration for any social providers you are using, the social providers auth screen will be customized with your app details. - -