Social preview images from a single URL

OgForge renders a 1200×630 PNG Open Graph image from query parameters: title, subtitle, label, emoji or logo, colors and one of five templates. Put the URL in your og:image tag and you're done. No sign-up, no SDK.

Works with X/Twitter, LinkedIn, Facebook, Slack, Discord, iMessage and anything else that reads Open Graph tags.

Example OgForge image: gradient template reading 'Ship faster with OgForge'

How it works

Build an image URL, then reference it from your page's head. The first request renders the PNG; repeat requests are served from cache.

<meta property="og:image" content="https://ogforge.mike-tusa.workers.dev/api/og?template=blog&amp;title=My%20first%20post&amp;site=example.com">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta name="twitter:card" content="summary_large_image">

Tip: URL-encode every value (encodeURIComponent in JavaScript, urllib.parse.quote in Python). The playground builds the URL and meta tags for you.

Five templates

Blog template example

blog: Blog post

Category label, big title, subtitle, and an author/site footer with your logo or an emoji.

Launch template example

launch: Product launch

Centered logo tile, a "now live" pill and a bold headline on a soft gradient.

Docs template example

docs: Docs / changelog

Monospace breadcrumb and version pill. Made for docs pages and release notes.

Minimal template example

minimal: Minimal

A large title, a thin accent rule and a small site line. Nothing else.

Gradient template example

gradient: Gradient

A vivid diagonal gradient (pick both colors) with white text on a glass card.

What you get

Fast and cached

Each unique set of parameters is rendered once, then served from memory and Cloudflare's cache with a one-year Cache-Control and an ETag.

Your brand

Custom background, text and accent colors, light or dark theme, an emoji (Twemoji) or your own PNG/JPEG/SVG logo.

Safe inputs

Long text is trimmed with an ellipsis instead of breaking the layout. Invalid values return a clear JSON error with a code.

Simple API

One GET endpoint, CORS enabled, no key needed. Bundled Inter and JetBrains Mono fonts.

Pricing

Free

$0
  • All 5 templates, colors, emoji and logos
  • About 20 new (uncached) renders per minute per IP
  • About 120 image requests per minute per IP (cached images are cheap)
  • Small “ogforge” badge in the corner
  • No sign-up, no API key

Pro Coming soon

—
  • No badge
  • Higher render limits with an API key
  • Custom fonts and templates

Paid plans are not available yet. Nothing is for sale.

Limits are approximate and enforced per Cloudflare location. See the pricing page and limits and error codes.

For AI agents (MCP)

OgForge is also a remote Model Context Protocol (MCP) server with one tool, create_og_image. Most MCP clients accept this config; some use a different format (for example, VS Code uses a servers key). Clients with a settings screen just need the URL https://ogforge.mike-tusa.workers.dev/mcp.

{ "mcpServers": { "ogforge": { "type": "http", "url": "https://ogforge.mike-tusa.workers.dev/mcp" } } }

Machine-readable docs: llms.txt · OpenAPI 3.1 spec

Privacy & acceptable use

We don't keep request logs, set cookies or run analytics scripts. To count unique visitors per day, we keep a salted hash of your network (IP address grouped by /64 for IPv6) and the date, which rotates daily and is deleted after 9 days; no IP address is stored. The text you put in an image URL is stored only as part of the cached image (in server memory and Cloudflare's cache). Your IP address is used only in short-lived rate-limit counters. The site runs on Cloudflare Workers, and Cloudflare processes requests in order to serve it.

Third-party requests: if you pass a logo URL, OgForge's server fetches that image itself (server-side, from Cloudflare, not from your visitors' browsers), so the logo's host sees a request from OgForge. Emoji graphics (Twemoji) are loaded server-side from the jsDelivr CDN (cdn.jsdelivr.net) when an image contains emoji. Visitors who view a generated image only ever contact OgForge.

Acceptable use: no impersonation, phishing or illegal content. Requests that match our denylist are refused with a 403, and reported images are taken down. Report abuse to digitalpromohub.support@gmail.com.