ogmake API docs
Everything to add OG images to a site: the core API and signing docs, and a guide per framework for wiring the image URL into your own templates.
Core docs
- Quickstart — Sign your first request and render an image in minutes.
- Signing — The canonical-string and HMAC-SHA256 signing algorithm, in five languages.
- API reference — Every route, field, and error code, generated from the OpenAPI document.
- Public URLs — Unsigned image URLs for static sites with no runtime to sign a request.
- OG image size — Recommended og:image and Twitter card sizes, aspect ratios and file limits for Facebook, LinkedIn and X, with safe-area tips.
- Editor guide — Pick a template, fill its fields, preview the card on X and LinkedIn, and get a PNG, a hosted URL or a meta tag.
- URL templates — Map a page's title, price and image to a template once, then give every page on your site its own card from one og:image line.
- Auto mode — Add one tag, or send the page URL from the API, and ogmake builds each page's card from the page itself: photo, price, page type and the site's style.
- Short links — Create an ogmake.com/s/ link to a public page. It previews as the page's card and opens the original.
- MCP server — Connect Claude, Cursor and other MCP clients to ogmake: render og:images, check pages and run batches from your assistant.
Framework guides
- Next.js — Signed URL in generateMetadata, with grid, z-index, CJK and emoji rendering built in.
- Django — Signed URL, computed in a view and passed to the template.
- Laravel — The ogmake/laravel package, or plain PHP without it.
- Rails — Signed URL from a view helper, with Rails credentials and CSP notes.
- Hugo — Public URL from a head partial — no signing at build time.
- Jekyll — Public URL that works on GitHub Pages' sandboxed builds.
- Ghost — Public URL from a default.hbs Handlebars helper.
- WordPress — Public URL from a functions.php wp_head hook.
Free tools
- OG image checker — Paste a URL, see its Open Graph and Twitter tags, the image size and previews on six platforms. Start here when a shared link looks wrong.
- Meta tag generator — Fill in a title, description, URL and image and copy the finished <head> tags, with live previews. Write the tags, then verify them in the OG image checker.
- Product page preview — Paste a product page URL and see the watermarked card ogmake builds from it: photo, price, domain and page type. No account.
- OG image generator — Type a title, get a 1200×630 og:image PNG. No account.
- Editor — Pick a template, fill its fields, export the PNG or the URL.
Troubleshooting
- og:image not showing — Why a shared link isn't showing its OG image on X, LinkedIn, Facebook, Slack or Discord, and how to fix it. Confirm the fix on your live URL with the OG image checker.