WordPress filter hook · part of WordPress core

pre_option

A WordPress core filter that 4 plugins also fire themselves, running on 130+ sites between them.

“Filters the value of all existing options before it is retrieved.”

How to use pre_option

It's a filter: your callback receives the value and 2 more arguments, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'pre_option', function( $pre, $option, $default ) {
	// Change $pre here.
	return $pre;
}, 10, 3 );

Argument names come from RevLifter's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

This hook is fired by WordPress core too. Official reference on developer.wordpress.org →

4 plugins that fire pre_option

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. AI Services icon AI Services100+ installs apply_filters( 'pre_option', $pre, $option, '' ) includes/Services/Entities/Service_Entity.php:207
  2. CYBERMAPS: XML Sitemaps & llms.txt icon CYBERMAPS: XML Sitemaps & llms.txt20+ installs apply_filters( 'pre_option', $pre, $option, $default_value ) src/Core/ConfigurationStore.php:97
  3. RevLifter icon RevLifter10+ installs apply_filters( 'pre_option', $pre, $option, $default ) public/class-revlifter-public.php:311
  4. PIS Tag Manager icon PIS Tag ManagerFewer than 10 installs apply_filters( 'pre_option', $pre, $option, $default ) public/class-pis-tag-manager-public.php:135

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.