add_site_option( string $option, mixed $value )

Add a new option for the current network.

Description Description

Existing options will not be updated. Note that prior to 3.3 this wasn’t the case.

Parameters Parameters


(string) (Required) Name of option to add. Expected to not be SQL-escaped.


(mixed) (Required) Option value, can be anything. Expected to not be SQL-escaped.

Top ↑

Return Return

(bool) False if the option was not added. True if the option was added.

Top ↑

Source Source

File: wp-includes/option.php

function add_site_option( $option, $value ) {
	return add_network_option( null, $option, $value );

Top ↑

Changelog Changelog

Version Description
4.4.0 Modified into wrapper for add_network_option()
2.8.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note content
    Contributed by Codex


    Default usage:

    add_site_option( 'my_option', 'my_value' );

    Behavior if the option already exists:

    echo get_site_option( 'i_exist_already' );
    // Output: 'some_value'
    if ( add_site_option( 'i_exist_already', 'new_value' ) ) {
       echo get_site_option( 'i_exist_already' );
    } else {
       echo __( 'Already exists', 'textdomain' );

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