Store setupUpdated 2026-06-01
Custom domains
Connect and verify your own domain with automatic TLS provisioning.
Every shop gets a saleporia subdomain out of the box. To use your own domain, verify it once and Saleporia handles TLS automatically.
Where to find it
Settings → Domain. Enter your domain (e.g. shop.example.com) and click Verify.
How verification works
- 1
Point DNS at Saleporia
Add a CNAME record for your subdomain pointing to the Saleporia edge. For apex domains, use an A record as instructed. - 2
Click Verify
Saleporia checks the DNS records against your domain. If they match, isDomainVerified is set to true. - 3
TLS is provisioned
On the first request, the edge issues an on-demand TLS certificate via the tls-ask hook and a Traefik domain route is upserted. CORS caches are invalidated so the new domain serves immediately.
Domain conflicts
A domain can only be attached to one shop at a time. If you enter a domain already in use by another shop, verification will fail with a conflict. Changing the domain resets verification and you'll need to re-verify.
Domain resolution
The public storefront resolves incoming hosts to shops via the /resolve-domain endpoint. When a request hits your custom domain, Saleporia looks up the shop by domain or slug and serves the correct storefront. The /tls-ask endpoint authorizes on-demand certificate issuance for verified domains only.
Domain endpoints (admin)
POST
/shop/domain/verifyVerify custom domain DNS and upsert the Traefik route.
SessionGET
/storefront/resolve-domainResolve a host to a shop for custom-domain routing.
PublicGET
/storefront/tls-askCaddy on-demand TLS authorization hook for verified domains.
Public