Brandable social cards

Embed
Preview of the card
<a href="https://forumulate.com/guides/social-cards"><img src="https://forumulate.com/guides/_api/public/orgs/046a9bc0-d530-43ae-9bae-af7945008cda/spaces/36aa4df0-1e95-4cef-8ae9-795169441345/pages/8b2b9724-7c3a-47bd-a8b3-3a22649d97cc/social-card.svg?v=3e7ae33eec8b" alt="Brandable social cards" width="600" height="315"></a>

Every space generates its own Open Graph card (social-card.png) for every page, collection, post and incident. Shape it once per space under the space's SEO settings (seo.socialCard) and every link shared from it looks like yours.

The template

Key

What it does

layout

classic (default — the card as it always rendered), split (an accent panel with your brand mark beside the title), centered, minimal (title and mark only), bold (full-bleed accent). Unset: the organization's discovery.social_card_layout, else classic.

eyebrow

The line above the title: space (default), collection (the page's collection), or none. eyebrowText replaces its words on every card.

logoUrl, logoPosition

Your brand mark (an https image or an asset-library path) and where it sits: top-right (default), top-left, bottom-right.

accent, background, backgroundTo, titleColor, eyebrowColor

Colours, as 6-digit hex.

font

sans, serif, mono, noto-sans, noto-serif.

titleSize

large (classic 72px), auto (long titles step down to fit), medium.

footer, accentBar

The credit line ('' removes it) and the brand stripe.

badge

A post field printed as a pill — a release date, a price.

Every key is optional; a space that sets none gets the same card as before.

Fonts

Cards are drawn on our servers with fonts installed alongside the renderer (DejaVu and Noto), never fetched from a third party — so a card renders the same everywhere and costs your readers no request to anyone.

Live preview

The SEO panel in the studio shows the card as you change it. The preview is drawn by the same renderer and fonts as the card a scraper fetches, so it is the card, not an approximation: POST /api/orgs/{org}/spaces/{space}/social-card/preview with { "template": { … } } (and optionally title, pageId, fields for the badge, format: "svg").

In the API

Every operation below is also reachable from the other surfaces without a dedicated command. forumulate api <Operation> calls it from the CLI, the JavaScript SDK has a typed method for each one (the last column names it; the Python and Go SDKs are generated from the same spec), and an agent reaches the organization-scoped ones through the MCP agent server — its api_* family tools, or call_api. Where a CLI command or a hand-made MCP tool exists too, the last column names it. Operation names link to the API reference.

Social Card Preview

Operation

Request

What it does

Shortcuts

SocialCardPreview_preview

POST /orgs/{orgId}/spaces/{spaceId}/social-card/preview

Preview the social card

client.socialCardPreview.preview()

The Forumulate teamUpdated