apply_filters( 'wp_revisions_to_keep', int $num, WP_Post $post )

Filters the number of revisions to save for the given post.


Overrides the value of WP_POST_REVISIONS.

Top ↑


$num int
Number of revisions to store.
$post WP_Post
Post object.

Top ↑

More Information

  • By default, an infinite number of revisions are stored if a post type supports revisions.
  • Note that the filter callback functions must return a value after it is finished processing or the revisions will be empty.

Top ↑


File: wp-includes/revision.php. View all references

$num = apply_filters( 'wp_revisions_to_keep', $num, $post );

Top ↑


Version Description
3.6.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Steven Lin

    Example migrated from Codex:

    The example below sets the number of revisions for a theoretical post type ‘my_custom_post’.

    add_filter( 'wp_revisions_to_keep', 'filter_function_name', 10, 2 );
    function filter_function_name( $num, $post ) {
        if( 'my_custom_post' == $post->post_type ) {
            $num = 5;
        return $num;

You must log in before being able to contribute a note or feedback.