diff --git a/website/docs/guides/docs/docs-create-doc.mdx b/website/docs/guides/docs/docs-create-doc.mdx
index caf8e2ea77..9a7e3a2a70 100644
--- a/website/docs/guides/docs/docs-create-doc.mdx
+++ b/website/docs/guides/docs/docs-create-doc.mdx
@@ -190,3 +190,6 @@ Lorem ipsum
 When using [autogenerated sidebars](./sidebar/autogenerated.mdx), the file structure will determine the sidebar structure.
 
 Our recommendation for file system organization is: make your file system mirror the sidebar structure (so you don't need to handwrite your `sidebars.js` file), and use the `slug` front matter to customize URLs of each document.
+
+
+Add a section explaining that setting the `id` frontmatter will also affect the published path of the document, making it `/{id}` instead of `/{filename}`.
\ No newline at end of file