close
Image

This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Image

Custom Post Type Cleanup

Description

Custom post type posts are left in the database if a post type is no longer registered (in use).

Plugins and themes can (without you knowing) use custom post types as a way to store data. These posts stay in the database forever if they’re not cleaned up by the plugin/theme itself upon deletion.

There are a lot of plugins that clean your database (by removing revisions, drafts etc.), but I haven’t found one that does a cleanup of unused post type posts.

This plugin provides an easy way to detect and remove posts from post types that are no longer in use. The settings page for this plugin is at wp-admin > Tools > Custom Post Type Cleanup.

Note: The proper WordPress delete function wp_delete_post is used instead of running a direct MySQL query to delete the posts. This way all associated post data (comments, post meta etc.) are also deleted from the database.

Since version 1.2.0 you can re-register unused custom post types for a limited period of time. This allows you to inspect and delete the posts like you would normally (in the wp-admin).

Screenshots

  • Image
    Plugin page
  • Image
    Plugin page after re-registering unused custom post types.
  • Image
    Plugin page after cleaning up all unused post type posts

Installation

Follow these instructions to install the plugin.

  1. In your WordPress admin panel, go to Plugins > New Plugin, search for “custom post type cleanup” and click “Install now”.
  2. Alternatively, download the plugin and upload the contents of custom-post-type-cleanup.zip to your plugins directory, which usually is /wp-content/plugins/.
  3. Activate the plugin
  4. Go to wp-admin > Tools > Custom Post Type Cleanup and see if there are unused custom post type posts in the database.

Reviews

Image
November 29, 2024
So I didn’t have to 🙂 Awesome little handy tool to clean up old sites from obsolete CPTs and their post meta. I wish it also supported custom taxonomies that were registered for those obsolete CPTs.
Image
May 7, 2024
Its a really simple to use plugin and working right out of the box. A nice feature would be (if that is possible at all) to clean up abandoned taxonomies, too. Thx for this nice plugin!
Image
April 23, 2024
What a useful, little plugin! It helps clean up the database and keep it clean from old and obsolete CPTs. Bravo to the developer who also swiftly updated it to the latest version shortly after my support request. What else can you ask for?
Image
May 14, 2023
Worked also for me today, hope it gets updates and keeps working, really usefull plugin.
Read all 35 reviews

Contributors & Developers

“Custom Post Type Cleanup” is open source software. The following people have contributed to this plugin.

Contributors

“Custom Post Type Cleanup” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Custom Post Type Cleanup” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.3.2

  • Tested plugin to WP 6.5 on newer PHP versions.

1.3.0

  • Add batch size option to admin form.

1.2.0

  • Add ability to re-register unused custom post types.