Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/jooosi-project/jooosi-social-image/archive/refs/heads/main.zip
Jooosi Social Image
Design dynamic Open Graph and featured images visually in WordPress, then keep them in sync with your content automatically.
[!NOTE]
Jooosi Social Image is an open-source WordPress plugin from Jooosi.
Overview
Jooosi Social Image is a visual image design and generation plugin for WordPress. Create branded Open Graph, X/Twitter, and featured images directly in WP Admin, connect each layout to live WordPress content, and choose exactly where it applies. Social Image generates static, content-hashed files in the background and refreshes only the images affected by a content or design change.
Features
- 🎨 Visual image editor: Drag, resize, rotate, reorder, lock, and style text, image, SVG, and shape layers in the browser.
- 🧩 Content-driven layouts: Preview and insert post, author, taxonomy, metadata, ACF, JetEngine, Meta Box, and Toolset values.
- 🗂️ Reusable templates: Start from 65 bundled templates or add validated public template repositories.
- 🎯 Flexible locations: Target content with nested all/any rules across post properties, taxonomies, metadata, text, and dates.
- 🖼️ Social and featured output: Generate Open Graph, X/Twitter, and optional Media Library featured images from one design.
- 🔄 Automatic regeneration: Render through WP-Cron with content-derived cache keys and targeted invalidation.
- ⚙️ Rendering choices: Use Imagick when available or GD with FreeType as a fallback.
- 🧰 Developer APIs: Render through the namespaced PHP API, shortcode, filters, REST endpoints, or WP-CLI.
- 🩺 Host diagnostics: Inspect renderer, SVG, local-font, WP-Cron, and uploads failures in Social Image settings or WordPress Site Health.
Requirements
- WordPress 7.0 or later
- PHP 8.0 or later
- Imagick, or GD with FreeType support
- Optional SVG layers: Jooosi Icon and PHP Imagick
- Optional managed fonts: Jooosi Fon with local TTF/OTF files
Installation
Install a release archive from the WordPress Plugins screen, activate Jooosi Social Image, then open WP Admin → Social Image.
Development
The admin application uses React 19, Tailwind CSS 4, and Vite. PHP code is namespaced under JooosiSocialImage\\ and release builds scope third-party dependencies under JooosiSocialImageDeps\\ to avoid conflicts with other WordPress plugins.
composer install
pnpm install
pnpm run dev
pnpm run typecheck
pnpm run check:presets
composer test
pnpm run test:e2e
Prepare the first release with pnpm run release -- 1.0.0, review the generated commit and tag, then push both to trigger the release workflow.
Sponsors
Jooosi Social Image is proudly supported by:
- Jooosi — open-source tools and products for WordPress.
- LiveCanvas — a visual site builder for WordPress.
External content
Some bundled Template previews use images hosted by Unsplash; six showcase Templates also retain an editable Unsplash URL when applied. Social Image only retrieves a remote image when the admin views the relevant Template or the site renders a Design that contains that URL. See the Unsplash License and Privacy Policy.
Administrators may add public Template repository URLs and image URLs from other hosts. Those requests are explicit, validated, and governed by the selected host's terms and privacy policy.