← buildlog og

Dynamic OG images for Hugo

Add the tag to your head partial; Hugo’s querify builds the query string. The API returns a 1200×630 PNG, cached at the edge.

{{/* layouts/partials/head.html */}}
{{ $q := querify "title" .Title "subtitle" (.Description | default .Summary | plainify | truncate 100) "site" site.BaseURL }}
<meta property="og:image" content="https://og.sadana.app/api/og?{{ $q }}">
<meta name="twitter:card" content="summary_large_image">

Works with any Hugo theme — override the theme’s head partial or append to it.

Preview

Example OG image for Hugo

Parameters

title     required, up to 200 chars
subtitle  optional
site      optional footer text
theme     light | dark (Pro)
key       Pro license key (removes watermark)

Check it

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.

Try the generator

Other frameworks

Next.js · Astro · Hugo · WordPress · Ghost · SvelteKit · Nuxt · Eleventy (11ty) · Jekyll · Docusaurus · plain HTML