upload_per_page

Filter Hook

Description

Filters the number of items to list per page when listing media items.

Hook Information

File Location	`wp-admin/includes/post.php` View on GitHub
Hook Type	Filter
Line Number	`1354`

Hook Parameters

Type	Name	Description
`int`	`$media_per_page`	Number of media to list. Default 20.

Usage Examples

Basic Usage

<?php
// Hook into upload_per_page
add_filter('upload_per_page', 'my_custom_filter', 10, 1);

function my_custom_filter($media_per_page) {
    // Your custom filtering logic here
    return $media_per_page;
}

Source Code Context

wp-admin/includes/post.php:1354 - How this hook is used in WordPress core

<?php
1349  	 *
1350  	 * @since 2.9.0
1351  	 *
1352  	 * @param int $media_per_page Number of media to list. Default 20.
1353  	 */
1354  	$q['posts_per_page'] = apply_filters( 'upload_per_page', $media_per_page );
1355  
1356  	$post_mime_types = get_post_mime_types();
1357  	if ( isset( $q['post_mime_type'] ) && ! array_intersect( (array) $q['post_mime_type'], array_keys( $post_mime_types ) ) ) {
1358  		unset( $q['post_mime_type'] );
1359  	}

PHP Documentation

<?php
/**
	 * Filters the number of items to list per page when listing media items.
	 *
	 * @since 2.9.0
	 *
	 * @param int $media_per_page Number of media to list. Default 20.
	 */

Quick Info

Hook Type: Filter
Parameters: 1
File: wp-admin/includes/post.php

Links

WordPress Docs View Source Code Search Examples

Related Hooks

Related hooks will be displayed here in future updates.