Title: WP_List_Table::get_items_per_page
Published: April 25, 2014
Last modified: May 20, 2026

---

# WP_List_Table::get_items_per_page( string $option, int $default_value = 20 ): int

## In this article

 * [Parameters](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#source)
 * [Hooks](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#hooks)
 * [Related](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#wp--skip-link--target)

Gets the number of items to display on a single page.

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#parameters)󠁿

 `$option`stringrequired

User option name.

`$default_value`intoptional

The number of items to display.

Default:`20`

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#return)󠁿

 int Number of items to display per page.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#source)󠁿

    ```php
    protected function get_items_per_page( $option, $default_value = 20 ) {
    	$per_page = (int) get_user_option( $option );
    	if ( empty( $per_page ) || $per_page < 1 ) {
    		$per_page = $default_value;
    	}

    	/**
    	 * Filters the number of items to be displayed on each page of the list table.
    	 *
    	 * The dynamic hook name, `$option`, refers to the `per_page` option depending
    	 * on the type of list table in use. Possible filter names include:
    	 *
    	 *  - `edit_comments_per_page`
    	 *  - `sites_network_per_page`
    	 *  - `site_themes_network_per_page`
    	 *  - `themes_network_per_page`
    	 *  - `users_network_per_page`
    	 *  - `edit_post_per_page`
    	 *  - `edit_page_per_page`
    	 *  - `edit_{$post_type}_per_page`
    	 *  - `edit_post_tag_per_page`
    	 *  - `edit_category_per_page`
    	 *  - `edit_{$taxonomy}_per_page`
    	 *  - `site_users_network_per_page`
    	 *  - `users_per_page`
    	 *
    	 * @since 2.9.0
    	 *
    	 * @param int $per_page Number of items to be displayed. Default 20.
    	 */
    	return (int) apply_filters( "{$option}", $per_page );
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-admin/includes/class-wp-list-table.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-admin/includes/class-wp-list-table.php#L978)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-admin/includes/class-wp-list-table.php#L978-L1009)

## 󠀁[Hooks](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#hooks)󠁿

 [apply_filters( “{$option}”, int $per_page )](https://developer.wordpress.org/reference/hooks/option/)

Filters the number of items to be displayed on each page of the list table.

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#related)󠁿

| Uses | Description | 
| [get_user_option()](https://developer.wordpress.org/reference/functions/get_user_option/)`wp-includes/user.php` |

Retrieves user option that can be either per Site or per Network.

  | 
| [apply_filters()](https://developer.wordpress.org/reference/functions/apply_filters/)`wp-includes/plugin.php` |

Calls the callback functions that have been added to a filter hook.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_list_table/get_items_per_page/?output_format=md#changelog)󠁿

| Version | Description | 
| [3.1.0](https://developer.wordpress.org/reference/since/3.1.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_list_table%2Fget_items_per_page%2F)
before being able to contribute a note or feedback.