OpenGraph+
Get Started

Mastodon Meta Tags

Which Open Graph, Twitter, and fediverse tags Mastodon actually reads

Tag priority order

Mastodon checks three sources for preview data, in order:

  1. oEmbed: fetched via <link rel="alternate" type="application/json+oembed">, but the rich type is rejected (only link, photo, and video are accepted)
  2. Open Graph tags: the primary source for most cards
  3. JSON-LD: only NewsArticle and WebPage schema types are parsed

Open Graph tags

Tag Purpose Required?
og:title Card headline (falls back to <title>) Yes
og:description Card body text No
og:image Card image No
og:image:alt Alt text for the image No
og:url Canonical URL for the card No
og:site_name Displayed as the card source No
og:type Content type hint No
og:locale Language hint No
og:author Author attribution No
article:published_time Publication date No

A card requires at least a title (from og:title or <title>) or an HTML embed via oEmbed. Without one, no card is generated.

Twitter tags (mostly ignored)

Mastodon skips the standard Twitter Card tags entirely:

  • twitter:card: ignored (layout is determined by image aspect ratio)
  • twitter:title: ignored
  • twitter:description: ignored
  • twitter:image: ignored

The only Twitter tags Mastodon reads are the twitter:player family (twitter:player, twitter:player:width, twitter:player:height, twitter:player:stream) for embedded video players.

The fediverse:creator tag

Added in Mastodon 4.3, fediverse:creator attributes content to a fediverse account. The author’s handle shows up on the preview card:

<meta name="fediverse:creator" content="@user@mastodon.social">

Must be a full handle including the instance domain. Mastodon verifies the account exists and that the linked domain appears in the account’s profile metadata.

Recommended minimal setup

<meta property="og:title" content="Your Page Title">
<meta property="og:description" content="A brief description of the page.">
<meta property="og:image" content="https://example.com/image.jpg">
<meta name="fediverse:creator" content="@you@mastodon.social">

No twitter:card tag needed. The image aspect ratio alone controls the card layout.