Skip to content

Document social sharing meta tag fallback behavior #5296

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ethanpalm merged 2 commits into from
Apr 13, 2026
+14 −8
Merged

Document social sharing meta tag fallback behavior #5296

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1f201dd
Document fallback behavior for page-level social sharing meta tags
mintlify[bot] Apr 10, 2026
a5fbe51
Apply suggestion from @ethanpalm
ethanpalm Apr 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 14 additions & 8 deletions optimize/seo.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,11 +25,11 @@ Mintlify generates the following meta tags for every page. You can override thes

**Page-specific metadata:**
- `title` - Page title, formatted as "Page Title - Site Name"
- `og:title` - Open Graph title, same as page title
- `twitter:title` - Twitter title, same as page title
- `og:title` - Open Graph title, defaults to page title
- `twitter:title` - Twitter title, falls back to `og:title`, then page title
- `description` - Page description
- `og:description` - Open Graph description, same as page description
- `twitter:description` - Twitter description, same as page description
- `og:description` - Open Graph description, falls back to page description
- `twitter:description` - Twitter description, falls back to `og:description`, then page description

**URL and canonical:**
- `canonical` - Automatically built from page URL
Expand Down Expand Up @@ -149,14 +149,14 @@ Page-specific meta tags include:
- `description` - Page description appears below the title on the page and in some search engine results
- `keywords` - Comma-separated keywords
- `og:title` - Open Graph title for social sharing
- `og:description` - Open Graph description
- `og:description` - Open Graph description, falls back to `description`
- `og:image` - Open Graph image URL
- `og:url` - Open Graph URL
- `og:type` - Open Graph type like "article" or "website"
- `og:image:width` - Open Graph image width
- `og:image:height` - Open Graph image height
- `twitter:title` - Twitter card title
- `twitter:description` - Twitter card description
- `twitter:title` - Twitter card title, falls back to `og:title`, then `title`
- `twitter:description` - Twitter card description, falls back to `og:description`, then `description`
- `twitter:image` - Twitter card image
- `twitter:card` - Twitter card type like `summary` or `summary_large_image`
- `twitter:site` - Twitter site handle
Expand All @@ -165,12 +165,18 @@ Page-specific meta tags include:
- `noindex` - Set to `true` to prevent search engine indexing
- `robots` - Robots meta tag value

<Tip>
Twitter meta tags automatically inherit from their Open Graph equivalents. For example, if you set `og:title` but not `twitter:title`, the Twitter card uses your `og:title` value. Set `twitter:title` or `twitter:description` explicitly only when you want different text on Twitter than on other platforms.
</Tip>

```mdx
---
title: "Your example page title"
description: "Page-specific description"
"og:image": "link to your meta tag image"
"og:title": "Social media title"
"og:description": "Custom description for social sharing"
"og:image": "link to your meta tag image"
"twitter:title": "Twitter-specific title"
keywords: ["keyword1", "keyword2"]
---
```
Expand Down
Loading