SEO Plugin Compatibility
Dynamic OG Image Generator does not replace your SEO plugin. It only handles og:image and twitter:image, and it does so by feeding the captured screenshot into your existing SEO plugin's image filters. Everything else your SEO plugin manages - meta descriptions, structured data, sitemaps, canonical URLs - keeps working exactly as before.
Supported SEO plugins
The plugin recognises and integrates with:
- Yoast SEO
- Rank Math
- All in One SEO (AIOSEO)
Detection is automatic. If one of these plugins is installed and active, integration is wired up. No configuration needed.
What each side handles
| Concern | Your SEO plugin | Dynamic OG Image Generator |
|---|---|---|
| og:image / twitter:image URL | Filters to receive the screenshot | Generates the screenshot, hooks the filter |
| og:title | Yes | No |
| og:description | Yes | No |
| og:type, og:url, og:site_name | Yes | No |
| Twitter card type | Yes | No |
| Schema.org structured data | Yes | No |
| Canonical URLs | Yes | No |
| Sitemaps | Yes | No |
In short: Dynamic OG Image Generator is a focused image source for the slot your SEO plugin already controls. It does not duplicate or compete with anything else.
How the integration works
When a screenshot is ready for a given post, the plugin hooks into your SEO plugin's image filter for that request and returns the screenshot URL instead of whatever default would otherwise be used. Specifically:
- Yoast SEO - hooks
wpseo_opengraph_imageandwpseo_twitter_image. - Rank Math - hooks
rank_math/opengraph/facebook/imageandrank_math/opengraph/twitter/image. - AIOSEO - hooks
aioseo_facebook_tagsandaioseo_twitter_tags.
Because the SEO plugin owns the actual emission of meta tags, everything in front of those filters (the rest of the page's open-graph metadata, validation, debug tooling) keeps behaving as normal.
What happens when there is no SEO plugin
If none of the supported SEO plugins are installed, Dynamic OG Image Generator emits its own complete og:image and twitter:image block into the page's <head>. The plugin works perfectly well on its own.
It still does not emit any other og tags. If you do not have an SEO plugin and you want a full set of social meta tags, you should install one.
What social platforms see while a screenshot is being generated
There is always a gap between a page being published and its screenshot being ready - typically a few seconds to a few minutes. The plugin's behaviour during that gap is set by the Image Source for the content type or the specific post, in OG Images > Settings and the block editor sidebar:
- Auto-screenshot - the plugin steps aside and lets your SEO plugin's existing og:image setting take effect until the screenshot lands. This is usually what you want: your SEO plugin is already configured with a sensible site-wide default and existing pages are unaffected until they get screenshotted. If you have no SEO plugin, no og:image tag is emitted for that brief window.
- Featured image - the post emits its Featured Image as og:image, end of story. No screenshot is ever captured for this content type, so no waiting period applies. If a post has no Featured Image, DOIG emits nothing and your SEO plugin's default applies if one is configured.
- Featured image (with screenshot when missing) - if the post has a Featured Image, that emits immediately. If it doesn't, the plugin queues a screenshot and behaves like Auto-screenshot mode for that post until the capture lands.
- Custom image - the post emits the picked Custom image from your Media Library, immediately and consistently. If no Custom image has been picked yet, DOIG emits nothing and your SEO plugin's default applies.
- Off - DOIG always steps aside on this post; your SEO plugin's default applies.
There is no separate "Fallback image" setting in 2.4.0 - the Image Source picker replaces it. The three pre-2.4.0 fallback behaviours (SEO plugin's default / Custom image / None) map onto the new picker as follows: "SEO plugin's default" is the implicit behaviour of every mode when DOIG has nothing to emit, "Custom image" is now its own per-post Source mode, and "None" maps to the Off Source.
What if my SEO plugin is updated and the filter names change?
The integration uses the filter names listed above. If a future version of one of those plugins renames or removes a filter, the integration would stop applying until updated to match. We monitor the supported plugins for changes and update the integration as needed. In the meantime, the plugin's own fallback emission path keeps working - your og:image is never simply absent.