Title: WP_Comments_List_Table::get_per_page
Published: April 25, 2014
Last modified: May 20, 2026

---

# WP_Comments_List_Table::get_per_page( string $comment_status = 'all' ): int

## In this article

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

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

Gets the number of comments to display per page.

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

 `$comment_status`stringoptional

Comment status.

Default:`'all'`

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

 int Comments per page.

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

    ```php
    public function get_per_page( $comment_status = 'all' ) {
    	$comments_per_page = $this->get_items_per_page( 'edit_comments_per_page' );

    	/**
    	 * Filters the number of comments listed per page in the comments list table.
    	 *
    	 * @since 2.6.0
    	 *
    	 * @param int    $comments_per_page The number of comments to list per page.
    	 * @param string $comment_status    The comment status name. Default 'All'.
    	 */
    	return apply_filters( 'comments_per_page', $comments_per_page, $comment_status );
    }
    ```

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

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

 [apply_filters( ‘comments_per_page’, int $comments_per_page, string $comment_status )](https://developer.wordpress.org/reference/hooks/comments_per_page/)

Filters the number of comments listed per page in the comments list table.

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

| Uses | Description | 
| [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.

  |

| Used by | Description | 
| [WP_Comments_List_Table::prepare_items()](https://developer.wordpress.org/reference/classes/wp_comments_list_table/prepare_items/)`wp-admin/includes/class-wp-comments-list-table.php` |

Prepares the comments list items.

  |

## User Contributed Notes

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