Custom frontmatter

organize/pages.mdx

@@ -10,17 +10,20 @@
 
 Every page starts with frontmatter, the YAML metadata enclosed by `---` at the beginning of a file. This metadata defines how your page appears and behaves.
 
-Use metadata to control:
+Use frontmatter to control:
 
 - Page titles and descriptions
 - Sidebar titles, icons, and tags
+- Page layouts
+- SEO meta tags
+- Custom metadata
 
 <ResponseField name="title" type="string" required>
   The title of your page that appears in navigation and browser tabs.
 </ResponseField>
 
 <ResponseField name="description" type="string">
   A brief description of what this page covers. Appears under the title and improves SEO.
 </ResponseField>
 
 <ResponseField name="sidebarTitle" type="string">
@@ -47,6 +50,10 @@
   A tag that appears next to your page title in the sidebar.
 </ResponseField>
 
+<ResponseField name="<custom>" type="string">
+  Any valid YAML frontmatter. For example, `product: "API"` or `version: "1.0.0"`.
+</ResponseField>
+
 ```yaml Example YAML frontmatter wrap
 ---
 title: "About frontmatter"
@@ -63,7 +70,7 @@
 
 ### Default
 
 If no mode is defined, defaults to a standard layout with a sidebar navigation and table of contents.
 
 ```yaml
 ---
@@ -73,7 +80,7 @@
 
 ### Wide
 
 Wide mode hides the table of contents. This is useful for pages that do not have any headings or if you prefer to use the extra horizontal space. Wide mode is available for all themes.
 
 ```yaml
 ---
@@ -140,10 +147,10 @@
 
 ## Search engine optimization
 
 Most SEO meta tags are automatically generated. You can set SEO meta tags manually to improve your site's SEO, social sharing, and browser compatibility.
 
 <Note>
   Meta tags with colons must be wrapped in quotes.
 </Note>
 
 ```yaml
@@ -152,11 +159,11 @@
 ---
 ```
 
 See [SEO](/optimize/seo) for complete SEO metadata options.
 
 ## Internal search keywords
 
 Enhance a specific page's discoverability in the built-in search by providing `keywords` in your metadata. These keywords won't appear as part of the page content or in search results, but users that search for them will be shown the page as a result.
 
 ```yaml
 ---