apply_filters( "default_site_option_{$option}", mixed $default, string $option, int $network_id )

Filters a specific default network option.


The dynamic portion of the hook name, $option, refers to the option name.

Top ↑



(mixed) The value to return if the site option does not exist in the database.


(string) Option name.


(int) ID of the network.

Top ↑


File: wp-includes/option.php

View on Trac

Top ↑


Version Description
4.7.0 The $network_id parameter was added.
4.4.0 The $option parameter was added.
3.4.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Giulio Daprela

    Using this filter will prevent you from creating or updating an option. This is likely a bug on WordPress.
    If you want to be able to save your option but still want to use the default for when it doesn’t exist yet, then you must remove the filter before updating the option.

    // remove the filter to prevent failure to add new option.
    remove_filter( 'default_site_option_my_network_option', 'setup_default_value', 10 );
    update_site_option( 'my_network_option', 'My Option Value' );

You must log in before being able to contribute a note or feedback.