OpenGraph Fallback Embed Icon

OpenGraph Fallback Embed

By Gary Pendergast

Active Installs

10+

Last Updated

March 25, 2026

First Released

March 25, 2026

Download History (Last one month)


Contributors

OpenGraph Fallback Embed adds a custom Gutenberg block and an auto-embed fallback that renders rich link cards using OpenGraph metadata from any URL.

Features:

  • OpenGraph Embed block — Paste any URL to embed it as a styled card showing the page’s title, description, image, and site name.
  • Auto-embed fallback — When WordPress can’t find an oEmbed provider for a URL pasted on its own line, this plugin automatically fetches the page’s OpenGraph tags and renders a card instead of a plain link.
  • Graceful degradation — Falls back to Twitter Card meta tags, then to HTML <title> and <meta name="description"> when OpenGraph tags are missing.
  • Transient caching — Fetched metadata is cached for 7 days to minimise external requests.

Development

The source code for this plugin, including unminified JavaScript and CSS, is available on GitHub:

OpenGraph Fallback Embed on GitHub

The plugin uses @wordpress/scripts for building. Source files are in the src/ directory. See the repository README for build instructions.

No installation instructions provided.

What happens if a URL has no OpenGraph tags?

The plugin falls back to Twitter Card meta tags, then to the page’s <title> and <meta name="description">. If none of these are available, the original WordPress output is preserved.

Does this override existing embed providers?

No. This plugin only activates when WordPress has no other embed handler for the URL.

Can I customise the card appearance?

The card uses the .og-fallback-embed CSS class. You can override styles in your theme.

Changelog

1.3.7

  • Added screenshots, and tweaked readme.txt.

1.3.6

  • Removed a dev file from the plugin zip.

1.3.5

  • Add source code repository link to readme.
  • Use plugin-specific prefix for transient cache keys.

1.3.4

  • Tweak the plugin header.

1.3.3

  • Remove one more file from the plugin zip.

1.3.2

  • Fix the block version number not being bumped in the last release.

1.3.1

  • Remove some unnecessary files from the plugin zip file.

1.3.0

  • Add support for falling back to OG tags when the Embed block fails.

1.2.0

  • Add custom Gutenberg block for manual OpenGraph embeds.
  • Add REST API endpoint for editor previews.
  • Improve fallback chain: OG Twitter Card HTML meta.

1.1.0

  • Add transient caching for fetched metadata.

1.0.0

  • Initial release with auto-embed fallback.

Available Versions

Version Download Type
1.3.7 Download Stable
Development Download Trunk

Plugin Info

  • Version: 1.3.7
  • Last Updated: March 25, 2026
  • Active Installs: 10+
  • WordPress Version: 6.3 or higher
  • Tested up to: 7.0.7
  • PHP Version: 7.4 or higher
  • Tags:    
    block card embed link opengraph

Ratings


0.0 out of 5 stars. (0 reviews)

See all reviews
Scroll to Top