> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crevio.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Custom domain
> Serve your Crevio storefront from your own domain and send emails from your own email domain.
Every Crevio account gets a free subdomain at `yourname.crevio.app` and a default outbound email address at `yourname@outbound.crevio.co`. You can customize both by connecting your own storefront domain and [email domain](/integrations/email-domain).
## Storefront custom domain
A storefront custom domain lets your store live on your own URL (e.g., `shop.yourbrand.com`) instead of `yourname.crevio.app`.
### Why use a custom domain
* **Branding** -- Your storefront URL matches your brand instead of showing `crevio.app`.
* **SEO** -- Search engines treat your domain as part of your own web presence, building domain authority for your brand rather than Crevio's.
* **Trust** -- Customers are more likely to purchase from a URL they recognize as yours.
* **Consistency** -- If you already have a website, your storefront feels like a natural extension of it.
## Default subdomain
When you create your Crevio account, you choose a subdomain. Your storefront is immediately available at:
```
https://yourname.crevio.app
```
This subdomain is always active, even after you connect a custom domain. Your subdomain must be:
* Between 2 and 42 characters
* Lowercase letters, numbers, and hyphens only
* Unique across all Crevio accounts
Certain subdomains are reserved (e.g., `admin`, `api`, `app`, `dashboard`, `www`) and cannot be used.
## Setting up a custom domain
In your dashboard, navigate to **Settings** > **Custom Domain**.
Type the domain you want to use (e.g., `shop.yourbrand.com` or `yourbrand.com`). Click **Save**.
Add a CNAME record at your domain registrar or DNS provider pointing to Crevio's target hostname. See the [DNS configuration](#dns-configuration) section below.
Crevio checks your DNS configuration automatically. Once verified, your domain goes through SSL provisioning and becomes active.
## DNS configuration
Add the following CNAME record to your domain's DNS settings:
| Type | Name | Target |
| ------- | -------------------------- | ---------------------- |
| `CNAME` | Your domain (e.g., `shop`) | `customers.crevio.app` |
If you are using a subdomain like `shop.yourbrand.com`, the **Name** field is `shop`. If you are using a root domain like `yourbrand.com`, some DNS providers require you to use `@` as the name or use an ALIAS/ANAME record instead of CNAME.
### Example DNS configurations
**Subdomain (recommended)**
| Type | Name | Target |
| ------- | ------ | ---------------------- |
| `CNAME` | `shop` | `customers.crevio.app` |
Your storefront will be available at `https://shop.yourbrand.com`.
**Root domain**
Root domains (`yourbrand.com` without a subdomain prefix) cannot use standard CNAME records due to DNS specifications. Check if your DNS provider supports one of these alternatives:
* **ALIAS record** (supported by DNSimple, AWS Route 53, and others)
* **ANAME record** (supported by Cloudflare, DNS Made Easy, and others)
* **CNAME flattening** (supported by Cloudflare)
If your provider does not support any of these, use a subdomain instead.
## Domain verification process
After you add the DNS record, Crevio verifies your domain in stages:
| Status | What it means |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pending** | Crevio is waiting for your DNS record to propagate. This typically takes a few minutes but can take up to 48 hours depending on your DNS provider. |
| **SSL pending** | DNS has been verified. Crevio is provisioning an SSL certificate for your domain. |
| **Active** | Your domain is verified, SSL is active, and your storefront is live on the custom domain. |
| **Error** | Something went wrong. Check that your DNS record is correct and try again. |
DNS propagation times vary by provider. If your domain stays in **Pending** for more than a few hours, double-check your CNAME record and ensure there are no conflicting records (like an existing A record on the same name).
## SSL / HTTPS
SSL certificates are provisioned **automatically** for your custom domain. You do not need to purchase, upload, or manage certificates yourself.
* Crevio uses Cloudflare for SSL provisioning.
* Certificates are issued and renewed automatically.
* All traffic is served over HTTPS. HTTP requests are redirected to HTTPS.
* Your customers always see the padlock icon in their browser.
## Troubleshooting
Verify that the CNAME record is correctly set up at your DNS provider. Use a tool like [dnschecker.org](https://dnschecker.org) to confirm that the record has propagated. Remove any conflicting A records on the same hostname.
SSL provisioning happens after DNS verification. If your domain is in **SSL pending** for more than an hour, try removing and re-adding the domain in your Crevio settings. Ensure your DNS provider is not proxying the CNAME record (if using Cloudflare for DNS, set the proxy status to **DNS only** / grey cloud).
Go to **Settings** > **Custom Domain**, remove the current domain, and add the new one. Update your DNS records accordingly. The old domain will stop serving your storefront once removed.
## Email domain
You can also send outbound emails from your own domain instead of `@outbound.crevio.co`. See the [Email domain](/integrations/email-domain) guide for setup instructions.