WordPress at a glance
filter is not described

set-screen-option filter-hook . WP 2.8.0

Filters a screen option value before it is set.

The filter can also be used to modify non-standard [items]_per_page settings. See the parent function for a full list of standard options.

Returning false to the filter will skip saving the current option.


add_filter( 'set-screen-option', 'filter_function_name_528', 10, 3 );
function filter_function_name_528( $keep, $option, $value ){
	// filter...

	return $keep;
Whether to save or skip saving the screen option value.
Default: false
The option name.
The number of rows to use.


Since 2.8.0 Introduced.

Where the hook is called

wp-admin/includes/misc.php 698
$value = apply_filters( 'set-screen-option', false, $option, $value );  // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

Where the hook is used (in WP core)

Usage not found!