> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: About Sitemaps in the Astro Integration

## Article: About Sitemaps in the Astro Integration

## Article Link: https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-sitemaps-in-the-astro-integration.md

## Article Content:

# About Sitemaps in the Astro Integration

On a Wix-managed headless project built with the [Astro integration](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/about-the-astro-integration.md), Wix generates and serves `/sitemap.xml` for you, the same as it does on a Wix Editor or Wix Studio site. What differs is what feeds it.

This article explains what the generated sitemap covers, how it relates to your deployed routes, and which sitemap paths the platform reserves. For the SEO tags themselves, such as titles, meta descriptions, and canonical links, see [About SEO Support](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support.md).

## What the generated sitemap covers

`/sitemap.xml` is a sitemap index, not a flat list of URLs. It lists:

- **`pages-sitemap.xml`**: Built from your page registry, served at `/_wix/pages.json`. This covers your main pages and any item-page routes you registered with `wixMetadata`.
- **A sitemap for each installed business solution**: For example, Wix Stores products and categories, Wix Blog posts and categories, Wix Bookings services, and Wix Events pages. Wix builds these the same way it does on an editor-built site.

A URL that doesn't come from either source isn't in the generated sitemap. To add a URL anyway, such as a dynamic item URL the page registry doesn't cover, see [Add URLs the generated sitemap doesn't cover](#add-urls-the-generated-sitemap-doesnt-cover) below.

<blockquote class="important">

__Important:__ `pages-sitemap.xml` reflects your deployed Astro routes, not pages built in an editor. A route appears there only if it exists in your published project. Removing a page from your navigation but leaving its `.astro` file in `src/pages/` doesn't remove the URL from the sitemap, because the route is still live. To remove a URL, delete or redirect the route, then run [`wix release`](https://dev.wix.com/docs/wix-cli/command-reference/project-commands/release.md) again.

</blockquote>

## Reserved sitemap paths

Wix reserves `/sitemap.xml` and every `*-sitemap.xml` path on managed headless hosting. Don't define an Astro route at one of these paths. It collides with the platform's route the same way a custom `robots.txt` route does. See [Reserved URL Paths for the Astro Integration](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/development/reserved-url-paths-for-the-astro-integration.md).

If you need to serve a sitemap or feed the platform doesn't generate for you, use a path that doesn't end in `-sitemap.xml`, such as `/sitemap-index.xml`.

## Add URLs the generated sitemap doesn't cover

The generated sitemap covers your page registry and your installed business solutions. For dynamic item URLs it doesn't cover, fetch them yourself with [List Sitemap Pages](https://dev.wix.com/docs/api-reference/business-management/headless/sitemap/headless-sitemap-entry-v1/list-sitemap-pages.md), filtered by `itemType`, and add them to a supplementary sitemap you serve at your own path. The method doesn't return static or main-page URLs, so use `/_wix/pages.json` for those instead.

## Troubleshooting

### `/sitemap.xml` returns a 404

If the site's overall indexability is turned off in the dashboard, `/sitemap.xml` returns a 404. This is standard across all Wix sites, not something specific to headless.

### A route doesn't appear in `pages-sitemap.xml`

The route isn't registered, or hasn't been published yet. Confirm it's listed in `/_wix/pages.json`, and that you've run `wix build` and `wix release` since adding it. For item-page routes specifically, see [Add SEO Support to Item Pages](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/add-seo-support-to-item-pages.md).

## See also

- [About SEO Support](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support.md)
- [Reserved URL Paths for the Astro Integration](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/development/reserved-url-paths-for-the-astro-integration.md)
- [Add SEO Support to Item Pages](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/add-seo-support-to-item-pages.md)
- [List Sitemap Pages](https://dev.wix.com/docs/api-reference/business-management/headless/sitemap/headless-sitemap-entry-v1/list-sitemap-pages.md)