---
title: Domains
description: "See your store's RetailPrime address, connect a domain of your own, follow it from Pending to Connected, make it primary, and remove it."
---

In **Settings**, press **Domains**. The page says **The addresses buyers use to reach your online store. The primary domain is the one shown in search results and links.** Every store starts with its **RetailPrime address** (such as `e2e-f8ffd91b.stg.retailprime.app`), **Primary** and **Connected**.

![The Domains page with the RetailPrime address, Primary, Connected, and Connect existing domain](/screenshots/settings/150-domains.jpg)

Press an address to open its page. The RetailPrime address's page says **Your store's RetailPrime address**, with its **Status**.

![The RetailPrime address's page: Connected and Primary](/screenshots/settings/151-generated-domain.jpg)

## Connect a domain you own

You need a domain you have bought from a domain provider. The example below is `www.sunnysocks.example.com`; use your own.

1. On the Domains page, press **Connect existing domain**. The page says **Use a domain you already own, such as www.example.com.**
2. In **Domain**, type the domain, starting with `www.` (or another subdomain): **Connect a subdomain such as www.example.com. To send buyers from example.com too, forward it to www.example.com at your domain provider.** A domain without `www.` is refused with a message such as **Connect a subdomain such as www.sunnysocks.com, then forward sunnysocks.com to it at your domain provider.**

   ![Connect existing domain with sunnysocks.com typed and the red message Connect a subdomain such as www.sunnysocks.com, then forward sunnysocks.com to it at your domain provider.](/screenshots/settings/152-root-domain-refused.jpg)

   ![Connect existing domain with www.sunnysocks.example.com typed, and Connect domain](/screenshots/settings/153-connect-domain.jpg)

3. Press **Connect domain**.

## Pending: add the DNS record

The domain's page says **Custom domain** and its status is **Pending**: **Add the DNS record below at your domain provider. The domain connects once the record is found and its certificate is issued, usually within a few minutes, though DNS changes can take up to 48 hours.**

The **DNS record** card says **Add this record at the provider where you bought the domain, and remove any other record for the same name.** It gives the **Type** (**CNAME**), the **Name** (your domain) and the **Value** (`connect.stg.retailprime.app`), each with a **Copy** button. Sign in at your domain provider and add that record.

![The domain's page: Pending, the DNS record card with CNAME, www.sunnysocks.example.com and connect.stg.retailprime.app, Redirect to primary domain ticked, Check now and Remove domain](/screenshots/settings/154-domain-pending.jpg)

## Connected

RetailPrime checks a pending domain a minute after you connect it, then every 5 minutes. To check at once, press **Check now**. The page says **Domain checked.**, and once the record is found the status is **Connected**, with **Last checked** and the time.

![The domain's page: Domain checked., Connected, Last checked, and Set as primary](/screenshots/settings/155-domain-connected.jpg)

A domain still pending after 7 days (or one your domain provider blocks or moves) becomes **Failed**: **This domain could not be connected and no longer reaches your store. Remove it, then connect it again once its DNS record is in place.**

:::note[Failed is not pictured]
The pictures in this guide are taken where every domain connects on its first check, so the **Failed** state could not be photographed.
:::

## Make it the primary domain

The **primary domain** is the address buyers are sent to and see in links. Press **Set as primary** on a connected domain. The page says **www.sunnysocks.example.com is now your primary domain.**

![The domain's page with www.sunnysocks.example.com is now your primary domain., Connected and Primary](/screenshots/settings/156-domain-primary.jpg)

The Domains page now shows **Primary** next to it.

![The Domains page with the RetailPrime address and www.sunnysocks.example.com, Primary, both Connected](/screenshots/settings/157-domains-two.jpg)

## Redirect to primary domain

Each address that isn't primary has **Redirect to primary domain**: **Send buyers who visit this domain to the same page on your primary domain.** It is ticked at first. Untick it to show your store on that address without redirecting; it is saved at once and the page says **This domain now shows your store without redirecting.** (Ticking it again says **This domain now redirects to your primary domain.**)

![The RetailPrime address's page with This domain now shows your store without redirecting., Redirect to primary domain not ticked, and Set as primary](/screenshots/settings/158-redirect-off.jpg)

To make the RetailPrime address primary again, open it and press **Set as primary**.

## Remove a domain

1. Open the domain and press **Remove domain**. The button is only there for a domain of your own that is not primary: to remove the primary one, make another address primary first.
2. A window asks **Remove www.sunnysocks.example.com?**: **Buyers who visit this domain will no longer reach your store.** and **You can connect it again later.**

   ![The Remove www.sunnysocks.example.com? window with Keep and Remove](/screenshots/settings/159-remove-domain.jpg)

3. Press **Remove**. You are back on the Domains page without it.

## What's next

[Notifications and webhooks](/settings-and-apps/notifications-and-webhooks): the emails your store sends, and sending its events to your own systems.
