---
title: "Store address and custom domains"
description: "Your store's Sherpo address, how to choose and change it, and your own domain on Pro."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.sherpo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Store address and custom domains

Every store has a Sherpo address, such as `your-store.sherpo.io`, where customers find it from the day you create it. On Pro and Sherpo One, a store can also be served on a domain of your own.

## Your Sherpo address

You pick the address when you create a store, under **Address**: `your-store` makes the store reachable at `https://your-store.sherpo.io`, as the merchant app shows below the field.

An address:

- is 6 to 63 characters long,
- uses lowercase letters, digits and hyphens, starting and ending with a letter or a digit,
- isn't taken by another store, and isn't one Sherpo keeps for itself (the app tells you when it is).

### Changing it

In the store's **Settings**, **Sherpo address** shows the current one. **Change address** moves the store and every link to it to the new address:

- Links to the old address keep reaching your store until you change the address again. Then they stop working, so update the links you've shared.
- Once it stops reaching your store, nobody else can take the old address for 90 days, so you can go back to it.

The merchant API's [get store](/merchant-api/reference/get-store) endpoint answers the store's `subdomain`, its main `hostname`, and every hostname it answers on in `hostnames`.

## Your own domain

Pro and Sherpo One include your own domain: your store served on an address such as `learn.example.com`, with no Sherpo address in sight. Lite stores use their Sherpo address alone. A store's **Plan & usage** page shows **Your own domain** as **Included** when its plan has it.

Connect it in the store's settings, under **Domain**:

1. Enter the domain and click **Connect**. A subdomain such as `learn.example.com` works with every DNS provider; a bare domain such as `example.com` needs one that supports CNAME flattening or ALIAS records.
2. Add the records the page lists at your DNS provider: a CNAME to the target shown, and the TXT record that proves the domain, while it's listed.
3. Once the records are in place, usually within an hour, the domain shows **Live**: your store answers on it with its own certificate, and it becomes the store's main address. Your Sherpo address keeps working and leads there.

On a move to a plan without your own domain, a live domain keeps working and can still be removed, while one that never went live doesn't become the store's main address until the plan includes a domain again.

A domain whose records aren't found within 14 days is let go, so you can connect it again once they're right. **Remove** takes the domain off, and the Sherpo address is the store's main one again. See [Store settings](/merchant-app/settings#domain) for every step.

## Addresses in the APIs

The customer API and the customer MCP server name a store by one of its hostnames: its Sherpo address or its own domain. The merchant API names it by its ID. See [Concepts](/overview/concepts#stores) for both.

The merchant API and the merchant MCP server manage a store's own domain as the settings page does, with the same plan, the same answers and the same limits: <a href="/merchant-api/reference/get-domain/">read domain</a> answers where it stands and the records it needs, <a href="/merchant-api/reference/connect-domain/">connect domain</a> connects one, <a href="/merchant-api/reference/check-domain/">check domain</a> checks its records now, and <a href="/merchant-api/reference/remove-domain/">remove domain</a> takes it off. The MCP tools are [`get_domain`](/merchant-mcp/tools/get_domain), [`connect_domain`](/merchant-mcp/tools/connect_domain), [`check_domain`](/merchant-mcp/tools/check_domain) and [`remove_domain`](/merchant-mcp/tools/remove_domain). Each needs a token or connection with the `site:read` scope to read, and `site:write` for the rest.

Source: https://docs.sherpo.io/overview/domains/index.mdx
