WP Manifestindependent plugin directory
manifest / utilities / oembed-cleaner

Equalize Digital oEmbed Cleaner

Cleans invalid oEmbed caches when posts transition from scheduled to published

by Equalize Digital · github.com/equalizedigital/oembed-cleaner

★ 0stars

Install

Download source zip No release zip yet

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/equalizedigital/oembed-cleaner/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/equalizedigital/oembed-cleaner ↗

Description

Equalize Digital oEmbed Cleaner is a lightweight WordPress plugin that automatically removes invalid oEmbed cache entries when posts transition from scheduled to published. This ensures that broken or outdated embed previews do not persist on your site.

Features

  • Cleans up _oembed_* post meta with {{unknown}} values.
  • Runs automatically when a scheduled post gets published.
  • Helps prevent outdated or broken oEmbed caches.
  • Simple, efficient, and does not add overhead to your site.

Installation

  1. Download the plugin ZIP or clone the repository.
  2. Upload the extracted folder to /wp-content/plugins/equalize-digital-oembed-cleaner/.
  3. Activate the plugin via Plugins > Installed Plugins in your WordPress dashboard.

How It Works

The plugin hooks into WordPress’s transition_post_status action and:

  • Detects when a post status changes from scheduled (future) to published.
  • Removes _oembed_* cache entries with {{unknown}} values in the postmeta table.

Changelog

1.0.0

  • Initial release.

License

This plugin is licensed under the GPL-2.0+.