Auth: X-Agent-Key: sq_agt_*. Scopes: store:read, store:publish. A store can have many domains attached, but only one primary domain. The primary is the address customers see, and the one every generated URL is built from — canonical tags, order emails, SMS links, shared links, and ad-pixel event URLs. Every other domain is in one of two modes. redirect is the default for newly attached domains — the same behaviour merchants expect from Shopify. Domains attached before this feature shipped stay on serve until you change them, so nothing started redirecting on its own.

​
Why the mode matters

Two domains both serving the same store are two copies of it as far as a search engine is concerned, and ranking is split between them rather than accumulated by either. Redirecting the aliases consolidates that into one address. The exception is deliberate: if a domain exists to be an ad landing page or a regional storefront, serve is correct and redirecting it would take it offline. Nothing changes a domain’s mode without you asking.

​
Endpoints

  • GET /domains — every attached domain with its mode, status and effective redirect target
  • PATCH /domains/{store_domain_id} — {"traffic_mode": "redirect" | "serve"}
  • PATCH /domains/{store_domain_id}/set-primary — promote a domain
  • POST /projects/{project_id}/domains — attach a new domain (provisions SSL)
Only verified domains can be promoted or change mode — an unverified domain has no certificate and therefore cannot answer at all.

​
Changing the primary domain

The promoted domain’s www/apex twin always switches to redirecting at it — a store serving both acme.com and www.acme.com as separate storefronts is never what anyone wants. redirect_others (default false) also folds every other attached domain into the new primary. Leave it off if any of them are standalone landing pages; turning it on is how you consolidate a store that has drifted into several copies of itself.
Changing the primary domain moves your store’s search identity to a new address. Rankings take weeks to follow. Redirects are kept in place so existing links, emails and ads keep working, but expect movement in search results.

​
Redirect behaviour

  • Status 301 by default; 302, 307 and 308 are accepted for a temporary move.
  • Path and query are preserved: old.com/products/x?utm=a → new.com/products/x?utm=a. Set preserve_path: false to send everything to the root instead.
  • Redirects are answered at the edge, before any request reaches your storefront, so a redirecting domain costs nothing to serve.
  • Certificate validation (/.well-known/) and email tracking pixels are never redirected — a redirecting domain still needs a working certificate, and a pixel must still render for someone who opens an old email.
  • Chains are rejected. A domain may redirect to the primary or to a serving domain, never to another redirect.

​
Your .myshopquantum.ai address

Every store keeps its platform subdomain, and it keeps working. Once you have a primary domain, the storefront tells search engines that the primary is the real address, so the subdomain does not compete with it.