WordPress at Your Fingertips
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 from the filter will skip saving the current option.


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

	return $screen_option;
The value to save instead of the option value.
Default: false (to skip saving the current option)
The option name.
The option value.


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 713
$screen_option = apply_filters( 'set-screen-option', $screen_option, $option, $value ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

Where in WP core the hook is used WordPress

Usage not found.