Title: default_option_{$option}
Published: April 25, 2014
Last modified: April 28, 2025

---

# apply_filters( “default_option_{$option}”, mixed $default_value, string $option, bool $passed_default )

## In this article

 * [Description](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#description)
 * [Parameters](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#wp--skip-link--target)

Filters the default value for an option.

## 󠀁[Description](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#description)󠁿

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

## 󠀁[Parameters](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#parameters)󠁿

 `$default_value`mixed

The default value to return if the option does not exist in the database.

`$option`string

Option name.

`$passed_default`bool

Was `get_option()` passed a default value?

## 󠀁[Source](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#source)󠁿

    ```php
    return apply_filters( "default_option_{$option}", $default_value, $option, $passed_default );
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/option.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/option.php#L199)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/option.php#L199-L199)

## 󠀁[Related](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#related)󠁿

| Used by | Description | 
| [update_option()](https://developer.wordpress.org/reference/functions/update_option/)`wp-includes/option.php` |

Updates the value of an option that was already added.

  | 
| [add_option()](https://developer.wordpress.org/reference/functions/add_option/)`wp-includes/option.php` |

Adds a new option.

  | 
| [get_option()](https://developer.wordpress.org/reference/functions/get_option/)`wp-includes/option.php` |

Retrieves an option value based on an option name.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/hooks/default_option_option/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.7.0](https://developer.wordpress.org/reference/since/4.7.0/) | The `$passed_default` parameter was added to distinguish between a `false` value and the default parameter value. | 
| [4.4.0](https://developer.wordpress.org/reference/since/4.4.0/) | The `$option` parameter was added. | 
| [3.4.0](https://developer.wordpress.org/reference/since/3.4.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fdefault_option_option%2F)
before being able to contribute a note or feedback.