diff --git a/astro.sidebar.ts b/astro.sidebar.ts
index d687faf69ba66..5392673a160ac 100644
--- a/astro.sidebar.ts
+++ b/astro.sidebar.ts
@@ -151,6 +151,7 @@ export const sidebar = [
'reference/experimental-flags/heading-id-compat',
'reference/experimental-flags/static-import-meta-env',
'reference/experimental-flags/chrome-devtools-workspace',
+ 'reference/experimental-flags/fail-on-prerender-conflict',
],
}),
'reference/legacy-flags',
diff --git a/src/content/docs/en/reference/experimental-flags/fail-on-prerender-conflict.mdx b/src/content/docs/en/reference/experimental-flags/fail-on-prerender-conflict.mdx
new file mode 100644
index 0000000000000..d55f79acbf8af
--- /dev/null
+++ b/src/content/docs/en/reference/experimental-flags/fail-on-prerender-conflict.mdx
@@ -0,0 +1,37 @@
+---
+title: Experimental prerender conflict error
+sidebar:
+ label: Prerender conflict error
+i18nReady: true
+---
+
+import Since from '~/components/Since.astro'
+
+
+
+**Type:** `boolean`
+**Default:** `false`
+
+
+
+Turns prerender conflict warnings into errors during the build process.
+
+Astro currently warns you during the build about any conflicts between multiple dynamic routes that can result in the same output path. For example `/blog/[slug]` and `/blog/[...all]` both could try to prerender the `/blog/post-1` path. In such cases, Astro renders only the [highest priority route](/en/guides/routing/#route-priority-order) for the conflicting path. This allows your site to build successfully, although you may discover that some pages are rendered by unexpected routes.
+
+With this experimental flag set, the build will instead fail immediately with an error. This will require you to resolve any routing conflicts immediately, and will ensure that Astro is building your routes as you intend.
+
+To enable this behavior, add the `experimental.failOnPrerenderConflict` feature flag to your Astro config:
+
+```js title="astro.config.mjs" ins={4-6}
+import { defineConfig } from "astro/config"
+
+defineConfig({
+ experimental: {
+ failOnPrerenderConflict: true,
+ },
+});
+```
+
+## Usage
+
+After enabling this flag, you may encounter errors about conflicting prerendered routes when you attempt to build your project. If this happens, you will need to update one or more of your [dynamic routes](/en/guides/routing/#dynamic-routes) to avoid ambiguous routing.