Connect a domain to StoreConnect

Use this process to connect your own domain or subdomain to your StoreConnect store. You create a Web Domain record to generate a DNS target, point a DNS record at that target, then activate the connection.

Before you begin

• You must own the domain, or have permission to manage its DNS settings.
• If the domain currently serves a live website, complete the go-live steps after step 1 and before step 2, so the store is ready before DNS sends visitors to it.
• Decide whether you are connecting an apex domain or a subdomain. This determines which DNS record type you create in step 2:
  • Subdomain (www.my-store.com, store.my-store.com) — use a CNAME record. Every DNS provider supports these.
  • Apex domain (my-store.com, with no www.) — use an ALIAS or ANAME record. Not all DNS providers support these. Cloudflare has neither, but accepts a CNAME record on the apex instead (see step 2). If your provider supports none of these, either forward the apex domain to your www subdomain, or move to a provider that supports ALIAS records.

:::tip Check your DNS provider’s ALIAS record support early in your project. Switching providers takes time and can affect your go-live timeline.

Set your DNS TTL to 60 seconds (or the lowest value your provider allows) before making changes. This speeds up propagation when you go live and makes issues easier to fix. You can increase it again once your domain is connected and stable. :::

Step 1: Create a Web Domain record

Do this first. The record generates the DNS target that step 2 needs.

1. Go to the Web Domains list.
2. Select New.
3. Enter your domain in the Domain Name field, with no https:// and no trailing /. For example:
   • www.my-store.com
   • my-store.com
   • store.my-store.com
4. Leave the Active checkbox clear for now. You select it in step 3, after DNS is in place.
5. Save the record.
6. Copy the value from the Target field, which generates automatically when you save. It looks something like afternoon-summer-aywe4qwsmeh.dns.storeconnect.app. You need it in the next step.

:::note Create a separate Web Domain record for each domain or subdomain you want to connect. To make your store reachable at both my-store.com and www.my-store.com, create two records. Each generates its own Target value. :::

If the record does not save, the message says why:

• The provisioning service did not respond as expected (Error: PROVISIONER_UNAVAILABLE) — StoreConnect’s domain service could not be reached. Your DNS settings are not the cause. Contact StoreConnect support with the full message.
• This org is not connected to its own store app yet — StoreConnect setup has not finished in this org. In a sandbox refreshed from production, run Get sandbox first. See set up your store again after a sandbox refresh.

Step 2: Configure DNS at your provider

:::warning If the domain serves a live website, set it on the Store record before you change DNS (see the go-live steps). Visitors reach StoreConnect as soon as the new record propagates, and a domain that no Store record claims shows the error No store could be found at that URL. :::

Log in to your DNS provider and add the record type for the domain you are connecting.

For a subdomain, for example www.my-store.com:

Add a CNAME record pointing to the Target value you copied.

For an apex domain, for example my-store.com:

Add an ALIAS or ANAME record pointing to the Target value you copied. If your DNS provider does not support these record types, forward the apex domain to your www subdomain instead.

If your DNS is hosted on Cloudflare:

Cloudflare has no ALIAS or ANAME record type. For an apex domain, add a CNAME record with the Name @ pointing to the Target value you copied. Cloudflare flattens a CNAME on the apex automatically, on every plan, so it behaves like an ALIAS record.

For every record you add on Cloudflare, apex or subdomain, set Proxy status to DNS only.

Step 3: Activate the connection

Complete this only once your DNS records are in place. Activating before DNS has propagated causes verification to fail.

1. Open the Web Domain record.
2. Select the Active checkbox.
3. Save the record.
4. Confirm verification has started: the Status field reads Enqueued.
5. Wait at least 10 minutes, then refresh the record and confirm Status reads Success. The domain is connected and SSL is provisioned.

Status values

Status	Meaning
Enqueued	Verification is in progress. Wait at least 10 minutes.
Success	The domain is connected and SSL is provisioned.
Failed	The connection failed. The Active checkbox is cleared automatically. Check the Message field for the reason.

If Status shows Failed:

1. Check the Message field for the reason.
2. Correct your DNS records.
3. Select Active again and save to retry.

Next step

A connected domain is not live until you set it on the Store record. See set your store domain and go live for the rest of the process. If the domain served a live website and you completed those steps before step 2, the store is live as soon as DNS propagates.