> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartble.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting a custom domain to your Cartble store

> Replace your default mycartble.com subdomain with your own domain by adding a CNAME record and verifying ownership through Cartble.

Every Cartble store comes with a default subdomain in the format `[your-slug].mycartble.com`, where `your-slug` is the unique identifier you chose during onboarding. If you want customers to reach your store at your own domain — for example, `shop.yourbrand.com` — you can connect a custom domain through your account settings.

## Plan requirement

Custom domains are an **add-on feature** available on higher-tier plans. The `customDomain` flag on your plan's `PlatformAddons` configuration must be enabled before the custom domain settings appear in your dashboard.

<Info>
  If you do not see the custom domain option in your settings, your current plan does not include it. Visit the **Billing** section of your dashboard to upgrade to a plan that includes the custom domain add-on.
</Info>

## How it works

When you connect a custom domain, Cartble saves it to your store configuration. Once Cartble confirms that your DNS is pointing to the platform correctly, your domain is marked as verified and your storefront goes live on it.

Cartble checks both the apex domain (e.g., `yourdomain.com`) and the `www` variant (e.g., `www.yourdomain.com`) automatically — you only need to configure one in your DNS settings.

## Connecting your domain

<Steps>
  <Step title="Open domain settings">
    In your admin dashboard, go to **Settings** and find the **Custom Domain** section.
  </Step>

  <Step title="Enter your domain">
    Type your custom domain into the domain field (e.g., `shop.yourbrand.com` or `www.yourbrand.com`) and click **Save**.
  </Step>

  <Step title="Get your DNS instructions">
    Cartble displays the DNS record you need to add. You will be given a **CNAME** record to add at your domain registrar or DNS provider.
  </Step>

  <Step title="Add the CNAME record">
    Log in to your DNS provider (for example, Cloudflare, GoDaddy, Namecheap, or Google Domains) and create a new CNAME record:

    | Field                 | Value                                                      |
    | --------------------- | ---------------------------------------------------------- |
    | **Type**              | `CNAME`                                                    |
    | **Name / Host**       | Your subdomain or `@` for the apex (e.g., `www` or `shop`) |
    | **Value / Points to** | The target hostname provided by Cartble                    |
    | **TTL**               | `Auto` or `3600`                                           |
  </Step>

  <Step title="Verify the domain">
    Return to your Cartble settings and click **Verify domain**. Cartble calls the verification endpoint to confirm your DNS record is resolving correctly. When verification succeeds, `customDomainVerified` is set to `true` and your store goes live on your custom domain.
  </Step>
</Steps>

<Warning>
  DNS changes can take anywhere from a few minutes to 48 hours to propagate globally, depending on your DNS provider and the TTL value on your records. If verification fails immediately after adding the record, wait 15–30 minutes and try again before contacting support.
</Warning>

## After verification

Once your domain is verified, visitors who go to your custom domain are served your Cartble storefront. Your default `[your-slug].mycartble.com` subdomain continues to work and redirects to your custom domain automatically.

<Note>
  HTTPS is provisioned automatically after your domain verifies. You do not need to configure an SSL certificate manually.
</Note>