diff --git a/pages.mdx b/pages.mdx
index 242f9f5e3..8c28b26fe 100644
--- a/pages.mdx
+++ b/pages.mdx
@@ -2,13 +2,19 @@
 title: "Pages"
 description: "Pages are the building blocks of your documentation"
 icon: "letter-text"
+keywords: ["tags", "tag"]
 ---
 
 Each page is an MDX file, which combines Markdown content with React components to let you create rich, interactive documentation.
 
 ## Page metadata
 
-Every page starts with frontmatter—YAML metadata enclosed by `---` at the beginning of your file. This metadata controls how your page appears and behaves.
+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:
+
+- Page titles and descriptions
+- Sidebar titles, icons, and tags
 
 <ResponseField name="title" type="string" required>
   The title of your page that appears in navigation and browser tabs.