Home

Welcome, and thanks for poking around. Image Socialiser gives every post, page, archive, and even your 404 a proper Open Graph sharing image: the picture social networks, chat apps, and search results show when someone links to you.

The whole thing runs on your own server. When you save a post, the image is rendered in the background (Imagick, with a GD fallback) and served as a plain static PNG. No external service, no per-image fees, no runtime HTTP calls. Also crawlers never trigger a render, they just read a meta tag pointing at a real file.

You set your design up once in the Design Center. Brand colours, fonts, logo, one of nine built-in designs – and everything picks it up. Change a colour and the filenames change with it, so caches invalidate themselves.

Getting started

1. Install and activate the plugin (PHP 8.3+, WordPress 6.6+).
2. Head to Settings → Social Images. The defaults work out of the box, so you can stop here if you like.
3. Set your brand colours, pick a design, and — if you want — turn on images for taxonomies, archives, and the special pages (front, blog, search, 404).

That's it. Save a post and watch a sharing image appear.

The pages here

• [Creating designs](https://github.com/krafit/image-socialiser/wiki/Creating-designs) — the full guide to design packs: the layer and token model, the design.json manifest, bundling your own fonts and background assets, previewing, and a worked example. Start here if you want to build a design from scratch.
• [For theme authors](https://github.com/krafit/image-socialiser/wiki/For-theme-authors) — how a theme hands design values over in code with add_theme_support( 'image-socialiser', … ), and which controls that takes over.
• [Developer reference](https://github.com/krafit/image-socialiser/wiki/Developer-Reference) — every hook, filter, option, function, and WP-CLI command, in one place.

Good to know

• It works with the SEO plugin you already have — The SEO Framework, Rank Math, Yoast SEO, All in One SEO, and SEOPress are supported through their own APIs. Run none of them and the plugin prints the tags itself. Podlove episode pages are handled too, and generated images become oEmbed thumbnails.
• Bring your own fonts — upload TTF/OTF files, or use faces installed through the WordPress Font Library.
• Multisite is properly supported, with network-wide defaults and per-section locks.

This is a beta

It's early days, and testing help is genuinely welcome — odd hosting setups, Imagick quirks, an SEO plugin combination I didn't think of, a design that renders wonky. Bug reports and "huh, that's weird" reports are equally useful over in [Issues](https://github.com/krafit/image-socialiser/issues). Point it at a staging site rather than production for now. 🙂