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 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:
- Enter the domain and click Connect. A subdomain such as
learn.example.comworks with every DNS provider; a bare domain such asexample.comneeds one that supports CNAME flattening or ALIAS records. - 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.
- 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 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 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: read domain answers where it stands and the records it needs, connect domain connects one, check domain checks its records now, and remove domain takes it off. The MCP tools are get_domain, connect_domain, check_domain and remove_domain. Each needs a token or connection with the site:read scope to read, and site:write for the rest.