diff --git a/pages.mdx b/pages.mdx
index 72212085a..26faa3e9a 100644
--- a/pages.mdx
+++ b/pages.mdx
@@ -5,8 +5,6 @@ icon: "letter-text"
 keywords: ["tags", "tag"]
 ---
 
-import IconsOptional from "/snippets/icons-optional.mdx";
-
 Each page is an MDX file, which combines Markdown content with React components to let you create rich, interactive documentation.
 
 ## Page metadata
@@ -30,7 +28,21 @@ Use metadata to control:
   A short title that displays in the sidebar navigation.
 </ResponseField>
 
-<IconsOptional />
+<ResponseField name="icon" type="string">
+  The icon to display.
+  
+  Options:
+  - [Font Awesome icon](https://fontawesome.com/icons) name
+  - [Lucide icon](https://lucide.dev/icons) name
+  - URL to an externally hosted icon
+  - Path to an icon file in your project
+</ResponseField>
+
+<ResponseField name="iconType" type="string">
+  The [Font Awesome](https://fontawesome.com/icons) icon style. Only used with Font Awesome icons. 
+  
+  Options: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`.
+</ResponseField>
 
 <ResponseField name="tag" type="string">
   A tag that appears next to your page title in the sidebar.