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_8570', 10, 3 );
function filter_function_name_8570( $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.
Since 5.4.2 Only applied to options ending with '_page', or the 'layout_columns' option.

Where the hook is called

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

Where in WP core the hook is used

Usage not found!