Skip to content

LinkCard

The card of the first link in a status: the title, description, and image that the linked page declares (Open Graph, X Card, and JSON-LD), fetched by the server after the status was posted or received. Omitted from a status with attachments or a poll, from a status whose link has no card yet, from a status whose link is on a domain where a rule of the crawler stops fetching, and when the instance setting link_cards is off. A card appears after its fetch, so a status read right after it was posted may have none.

Clients show the card as one link to url and, under a content warning, only once the warning is opened. When the status is sensitive, the image is hidden until the viewer shows it. A rule of the crawler can leave the card without its image.

object
url
required

The page that the card links to, after redirects.

string format: uri
title
required

The title of the page, as plain text.

string
description
required

The description of the page, as plain text; empty when it has none.

string
site_name
required

The name of the site, as plain text; the host of url when the page names none.

string
author_name

The author that the page names, as plain text; omitted when it names none.

string
published_at

When the page says it was published; omitted when it does not say.

string format: date-time
language

The BCP 47 language of the page; omitted when it does not say.

string
image

Schema: LinkCardImage

object
author

The account that the page names as its creator (fediverse:creator), given only when the account’s server lists the page’s domain among its attributionDomains.

Schema: Account

object

Example generated

{
"url": "https://example.com",
"title": "example",
"description": "example",
"site_name": "example",
"author_name": "example",
"published_at": "2026-04-15T12:00:00Z",
"language": "example",
"image": {},
"author": {}
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site