Title: _get_list_table
Published: April 25, 2014
Last modified: August 20, 2026

---

# _get_list_table( string $class_name, array $args = array() ): 󠀁[WP_List_Table](https://developer.wordpress.org/reference/classes/wp_list_table/)󠁿|false

## In this article

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

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

Fetches an instance of a [WP_List_Table](https://developer.wordpress.org/reference/classes/wp_list_table/)
class.

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

 `$class_name`stringrequired

The type of the list table, which is the class name.

`$args`arrayoptional

Arguments to pass to the class. Accepts `'screen'`.

Default:`array()`

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

 [WP_List_Table](https://developer.wordpress.org/reference/classes/wp_list_table/)
|false List table object on success, false if the class does not exist.

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

    ```php
    function _get_list_table( $class_name, $args = array() ) {
    	$core_classes = array(
    		// Site Admin.
    		'WP_Posts_List_Table'                         => 'posts',
    		'WP_Media_List_Table'                         => 'media',
    		'WP_Terms_List_Table'                         => 'terms',
    		'WP_Users_List_Table'                         => 'users',
    		'WP_Comments_List_Table'                      => 'comments',
    		'WP_Post_Comments_List_Table'                 => array( 'comments', 'post-comments' ),
    		'WP_Links_List_Table'                         => 'links',
    		'WP_Plugin_Install_List_Table'                => 'plugin-install',
    		'WP_Themes_List_Table'                        => 'themes',
    		'WP_Theme_Install_List_Table'                 => array( 'themes', 'theme-install' ),
    		'WP_Plugins_List_Table'                       => 'plugins',
    		'WP_Application_Passwords_List_Table'         => 'application-passwords',

    		// Network Admin.
    		'WP_MS_Sites_List_Table'                      => 'ms-sites',
    		'WP_MS_Users_List_Table'                      => 'ms-users',
    		'WP_MS_Themes_List_Table'                     => 'ms-themes',

    		// Privacy requests tables.
    		'WP_Privacy_Data_Export_Requests_List_Table'  => 'privacy-data-export-requests',
    		'WP_Privacy_Data_Removal_Requests_List_Table' => 'privacy-data-removal-requests',
    	);

    	if ( isset( $core_classes[ $class_name ] ) ) {
    		foreach ( (array) $core_classes[ $class_name ] as $required ) {
    			require_once ABSPATH . 'wp-admin/includes/class-wp-' . $required . '-list-table.php';
    		}

    		if ( isset( $args['screen'] ) ) {
    			$args['screen'] = convert_to_screen( $args['screen'] );
    		} elseif ( isset( $GLOBALS['hook_suffix'] ) ) {
    			$args['screen'] = get_current_screen();
    		} else {
    			$args['screen'] = null;
    		}

    		/**
    		 * Filters the list table class to instantiate.
    		 *
    		 * @since 6.1.0
    		 *
    		 * @param string $class_name The list table class to use.
    		 * @param array  $args       An array containing _get_list_table() arguments.
    		 */
    		$custom_class_name = apply_filters( 'wp_list_table_class_name', $class_name, $args );

    		if ( is_string( $custom_class_name ) && class_exists( $custom_class_name ) ) {
    			$class_name = $custom_class_name;
    		}

    		return new $class_name( $args );
    	}

    	return false;
    }
    ```

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

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

 [apply_filters( ‘wp_list_table_class_name’, string $class_name, array $args )](https://developer.wordpress.org/reference/hooks/wp_list_table_class_name/)

Filters the list table class to instantiate.

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

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

Get the current screen object

  | 
| [convert_to_screen()](https://developer.wordpress.org/reference/functions/convert_to_screen/)`wp-admin/includes/template.php` |

Converts a screen string to a screen object.

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

  |

[Show 1 more](https://developer.wordpress.org/reference/functions/_get_list_table/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/_get_list_table/?output_format=md#)

| Used by | Description | 
| [wp_ajax_search_install_plugins()](https://developer.wordpress.org/reference/functions/wp_ajax_search_install_plugins/)`wp-admin/includes/ajax-actions.php` |

Handles searching plugins to install via AJAX.

  | 
| [wp_ajax_search_plugins()](https://developer.wordpress.org/reference/functions/wp_ajax_search_plugins/)`wp-admin/includes/ajax-actions.php` |

Handles searching plugins via AJAX.

  | 
| [display_theme()](https://developer.wordpress.org/reference/functions/display_theme/)`wp-admin/includes/theme-install.php` |

Prints a theme on the Install Themes pages.

  | 
| [display_themes()](https://developer.wordpress.org/reference/functions/display_themes/)`wp-admin/includes/theme-install.php` |

Displays theme content based on theme list.

  | 
| [install_theme_information()](https://developer.wordpress.org/reference/functions/install_theme_information/)`wp-admin/includes/theme-install.php` |

Displays theme information in dialog box form.

  | 
| [wp_plugin_update_row()](https://developer.wordpress.org/reference/functions/wp_plugin_update_row/)`wp-admin/includes/update.php` |

Displays update information for a plugin.

  | 
| [wp_theme_update_row()](https://developer.wordpress.org/reference/functions/wp_theme_update_row/)`wp-admin/includes/update.php` |

Displays update information for a theme.

  | 
| [wp_dashboard_recent_comments()](https://developer.wordpress.org/reference/functions/wp_dashboard_recent_comments/)`wp-admin/includes/dashboard.php` |

Show Comments section.

  | 
| [wp_comment_reply()](https://developer.wordpress.org/reference/functions/wp_comment_reply/)`wp-admin/includes/template.php` |

Outputs the in-line comment reply-to form in the Comments list table.

  | 
| [wp_ajax_add_user()](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/)`wp-admin/includes/ajax-actions.php` |

Handles adding a user via AJAX.

  | 
| [wp_ajax_inline_save()](https://developer.wordpress.org/reference/functions/wp_ajax_inline_save/)`wp-admin/includes/ajax-actions.php` |

Handles Quick Edit saving a post from a list table via AJAX.

  | 
| [wp_ajax_inline_save_tax()](https://developer.wordpress.org/reference/functions/wp_ajax_inline_save_tax/)`wp-admin/includes/ajax-actions.php` |

Handles Quick Edit saving for a term via AJAX.

  | 
| [wp_ajax_add_tag()](https://developer.wordpress.org/reference/functions/wp_ajax_add_tag/)`wp-admin/includes/ajax-actions.php` |

Handles adding a tag via AJAX.

  | 
| [wp_ajax_get_comments()](https://developer.wordpress.org/reference/functions/wp_ajax_get_comments/)`wp-admin/includes/ajax-actions.php` |

Handles getting comments via AJAX.

  | 
| [wp_ajax_replyto_comment()](https://developer.wordpress.org/reference/functions/wp_ajax_replyto_comment/)`wp-admin/includes/ajax-actions.php` |

Handles replying to a comment via AJAX.

  | 
| [wp_ajax_edit_comment()](https://developer.wordpress.org/reference/functions/wp_ajax_edit_comment/)`wp-admin/includes/ajax-actions.php` |

Handles editing a comment via AJAX.

  | 
| [wp_ajax_fetch_list()](https://developer.wordpress.org/reference/functions/wp_ajax_fetch_list/)`wp-admin/includes/ajax-actions.php` |

Handles fetching a list table via AJAX.

  | 
| [post_comment_meta_box()](https://developer.wordpress.org/reference/functions/post_comment_meta_box/)`wp-admin/includes/meta-boxes.php` |

Displays comments for post.

  |

[Show 13 more](https://developer.wordpress.org/reference/functions/_get_list_table/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/_get_list_table/?output_format=md#)

## 󠀁[Changelog](https://developer.wordpress.org/reference/functions/_get_list_table/?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%2Ffunctions%2F_get_list_table%2F)
before being able to contribute a note or feedback.