Skip to content

Commit

Permalink
Clarify SSR limitations of sitemaps of dynamic routes (#7625)
Browse files Browse the repository at this point in the history
While this README doesn't distinguish between SSR mode and static mode (and SSR mode was recently made available for the sitemaps integration), there is one important difference: Dynamic routes that are server-rendered can't be used to create sitemap entries.

This note makes that clear.
  • Loading branch information
paulrudy authored Jul 14, 2023
1 parent 1f2d52b commit 9352ac6
Showing 1 changed file with 3 additions and 0 deletions.
3 changes: 3 additions & 0 deletions packages/integrations/sitemap/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,9 @@ A sitemap file is recommended for large multi-page sites. If you don't use a sit

With Astro Sitemap, you don't have to worry about creating this file: build your Astro site how you normally would, and the Astro Sitemap integration will crawl your routes and create the sitemap file.

> **Note**
> [Dynamic routes](https://docs.astro.build/en/core-concepts/routing/#dynamic-routes) like `[...slug]` or `src/pages/[lang]/[version]/info.astro` will generate sitemap entries for the pages those routes render, _provided that they are rendered statically_ (i.e., using `getStaticPaths()`. But because of the nature of [Astro's SSR mode](https://docs.astro.build/en/guides/server-side-rendering/), any dynamic routes that are server-rendered (via Astro's server or hybrid modes) do not output a static array of pages, so they will _not_ generate corresponding sitemap entries.
## Installation

### Quick Install
Expand Down

0 comments on commit 9352ac6

Please sign in to comment.