On a Wix-managed headless project, the wix() Astro integration registers its own routes into your project as part of the build, at a known set of paths. Those routes live in the same router as the routes you define, so a route you add at one of those paths collides with the one the integration already registered.
On a connected domain, meaning a custom domain you've connected to your project, Wix serves a smaller set of paths itself. Requests to those paths never reach your project. The following sections cover both sets.
Knowing which paths the platform claims helps you:
Because the integration's routes and your routes share a router, adding a route at a claimed path doesn't cleanly override the platform's route. Astro logs a router-collision warning at build and dev time. For /robots.txt specifically, Astro currently serves your project's route instead of the platform's, so your project stops serving the robots.txt file a Wix user manages in the dashboard. See About SEO Support.
Some claimed paths have a configuration option to turn them off instead. For example, wix({ robots: false }) stops the integration from registering /robots.txt at all, so you can serve your own route there without a collision. The table in the next section notes which paths have a configuration option. If a path isn't noted, avoid the collision by choosing a different path instead.
| Path or pattern | What it's for |
|---|---|
/_api/* | Requests the platform's own viewer components make to Wix. Also includes /_api/mcp, every site's built-in MCP server. See About the Wix Site MCP. Call Wix APIs from your own server code, or use /api/* for your own endpoints, instead of adding routes here. |
/api/auth/login | Starts the member login flow. Built in. See Add Member Login with the Astro Integration. |
/api/auth/callback | Completes the member login flow. Built in. Don't link to it directly. |
/api/auth/logout and /api/auth/logout-callback | Log the member out. Built in. |
/checkout and /__ecom/checkout | Wix-hosted checkout. |
/_paylink/[id] | Payment-link pages. |
/_proposal/[id] | Proposal pages. |
/robots.txt | The robots.txt file a Wix user manages in the dashboard. Turn this off with wix({ robots: false }) if you want to serve your own. |
/sitemap.xml and other *-sitemap.xml paths | The generated sitemap index and its per-vertical sitemaps. See About Sitemaps in the Astro Integration. |
/_wix/pages.json | Your page registry. |
/_wix/extensions/* | Backoffice, service-plugin, and webhook calls for your project's extensions. |
The path set by adminPathname | The admin redirect. You choose this path yourself with the integration's adminPathname option. |
Everything under /_wix/ belongs to the platform. Define your own endpoints under /api/ instead, apart from the built-in /api/auth/* routes above, and check your build output for collision warnings. Warnings cover only the paths in this table. The paths in the next section fail silently.
Only /sitemap.xml and its *-sitemap.xml siblings relate to the generated sitemap. The other claimed paths in this table, such as /checkout and /api/auth/*, don't relate to sitemap content.
Wix also serves a few paths itself, before the request reaches your project. These paths aren't Astro routes. The wix() integration doesn't register them, so adding a route at one of these paths produces no router-collision warning, and no configuration option stops Wix from serving the path. Your route builds and runs, but on a connected domain Wix serves its own response at that path instead.
Wix serves the following paths on a connected domain:
/.well-known/acme-challenge/*: SSL certificate validation during domain setup. Wix serves the ACME challenge tokens at this path while issuing or renewing your domain's certificate./.well-known/apple-developer-merchantid-domain-association: Apple Pay domain verification. Wix serves the verification file Apple requires when you accept Apple Pay on a connected domain./.well-known/assetlinks.json: Android App Links verification for Wix-hosted login. Wix serves this on the www subdomain only./.well-known/connection-check/*: Domain connectivity checks Wix runs during SSL setup and validation.Astro serves the following from your own routes:
/api/<your-endpoint>./google-merchant-feed.xml./about, /shop, and /product/[handle].Last updated: 29 September 2026