diff --git a/CLAUDE.md b/CLAUDE.md
index 10c27f65c..fc07104f1 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -81,7 +81,7 @@ This is **not a managed monorepo** (no Lerna, pnpm workspaces, etc.). Each folde
 
 **Content Structure:**
 - `.mdx` and `.md` files for documentation pages
-- YAML frontmatter for metadata (title, description, og/twitter tags)
+- YAML frontmatter for metadata (title, description)
 - `docs.json` defines navigation structure and Mintlify configuration
 
 **Reusable Components:**
diff --git a/main/CLAUDE.md b/main/CLAUDE.md
index 3bbb1060c..6bd6fe26d 100644
--- a/main/CLAUDE.md
+++ b/main/CLAUDE.md
@@ -56,13 +56,7 @@ All documentation files follow this structure:
 ---
 title: "Page Title"
 description: "SEO description for search engines"
-'og:image': https://cdn2.auth0.com/docs/...
-'og:title': "Social media title"
-'og:url': https://auth0.com/docs/path
-permalink: unique-path-slug
 sidebarTitle: "Optional sidebar label"
-'twitter:description': "Twitter card description"
-'twitter:title': "Twitter card title"
 ---
 
 import { Component } from '/snippets/component.jsx';
@@ -77,7 +71,7 @@ export const codeExample2 = `more code here`;
 
 ### Key Conventions
 
-1. **Frontmatter**: All MDX files require complete YAML frontmatter with SEO metadata
+1. **Frontmatter**: All MDX files require complete YAML frontmatter
 2. **Code Examples**: Export code as constants at the top of the file (after imports, before content)
 3. **Imports**: Custom components imported from `/snippets/` directory
 4. **Permalinks**: Used for stable URLs and redirects