Skip to main content

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.

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.
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.

​
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

1

Open domain settings

In your admin dashboard, go to Settings and find the Custom Domain section.
2

Enter your domain

Type your custom domain into the domain field (e.g., shop.yourbrand.com or www.yourbrand.com) and click Save.
3

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.
4

Add the CNAME record

Log in to your DNS provider (for example, Cloudflare, GoDaddy, Namecheap, or Google Domains) and create a new CNAME record:
FieldValue
TypeCNAME
Name / HostYour subdomain or @ for the apex (e.g., www or shop)
Value / Points toThe target hostname provided by Cartble
TTLAuto or 3600
5

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.
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.

​
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.
HTTPS is provisioned automatically after your domain verifies. You do not need to configure an SSL certificate manually.