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.
• 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. If yours does not, 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. :::

Switching a live site to StoreConnect

Complete this section only if the domain you are connecting currently serves a live website. If the domain is not yet in use, skip to step 1.

:::warning Make these changes in Salesforce before you configure DNS in step 2. Visitors reach StoreConnect as soon as the new DNS record propagates, and a domain that no Store record claims shows the error No store could be found at that URL. :::

Finish your site checks first. Clearing Enable Test Mode means the store takes real payments from real customers.

1. Open the Store record you are taking live.
2. Enter your domain in the Store Domain Name field, with no https:// and no trailing /. Include the path if your store uses one.
3. In the Modes section, clear the Enable Test Mode checkbox. Otherwise every order placed on the new domain is treated as a test order.
4. Save the record.
5. Go to Setup > Custom Metadata Types > StoreConnect Setting and select Manage Records.
6. Open Site Base URL and set Setting to your live domain, including the scheme, for example https://www.my-store.com. Do not add a trailing slash.
7. Update the callback URL on every web-to-case form to the new domain.
8. Update the callback URL on every web-to-lead form to the new domain.
9. Allow a few minutes for the data to sync.

Your Store record now claims the domain, so visitors reach your storefront instead of an error the moment DNS propagates. Continue with step 1 below.

For the full launch sequence, including the dry run and the post-launch checks, see Prepare to launch your store.

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

Step 2: Configure DNS at your provider

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.

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 you already did this as part of switching a live site, your store goes live as soon as DNS propagates.