Build the URL in your base Nunjucks layout with the urlencode filter. The API returns a 1200×630 PNG, cached at the edge.
{# _includes/base.njk #}
<meta property="og:image" content="https://og.sadana.app/api/og?title={{ title | urlencode }}&subtitle={{ description | urlencode }}&site=yourblog.dev">
<meta name="twitter:card" content="summary_large_image">No async shortcode or build-time rendering needed.
title required, up to 200 chars subtitle optional site optional footer text theme light | dark (Pro) key Pro license key (removes watermark)
After deploying, paste a URL into a card validator (e.g. opengraph.xyz) or share it in a private Slack/Discord channel. Social crawlers cache images, so change the URL (e.g. add &v=2) to force a refresh.
Next.js · Astro · Hugo · WordPress · Ghost · SvelteKit · Nuxt · Eleventy (11ty) · Jekyll · Docusaurus · plain HTML