Routing Config

Docs groups and docs sets own docs route namespaces. Optional Pages collision checks can reject unsafe overlaps with your Pages collection.

1payloadMarkdownDocs({2  routing: {3    pages: {4      enabled: true,5      collection: 'pages',6      routeField: 'slug',7      allowBridgePages: true,8      bridgeField: 'docsBridge',9    },10  },11})

Pages Checks

When enabled, docs-side Pages checks can reject:

• an exact docs set route colliding with a Page
• a Page route inside a docs set namespace
• a generated doc route colliding with a Page

Ancestor Pages can still exist. For example, a Page at /plugins can coexist with a docs set at /plugins/payload-markdown-docs.

Bridge Pages

A bridge Page is an optional convention for one Page per docs set or docs group. It can help your site navigation point to docs without creating one Page per Markdown file.