Title: WP_Customize_Widgets::get_captured_option
Published: April 23, 2015
Last modified: May 20, 2026

---

# WP_Customize_Widgets::get_captured_option( string $option_name, mixed $default_value = false ): mixed

## In this article

 * [Parameters](https://developer.wordpress.org/reference/classes/wp_customize_widgets/get_captured_option/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/wp_customize_widgets/get_captured_option/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/wp_customize_widgets/get_captured_option/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wp_customize_widgets/get_captured_option/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_customize_widgets/get_captured_option/?output_format=md#changelog)

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

Retrieves the option that was captured from being saved.

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

 `$option_name`stringrequired

Option name.

`$default_value`mixedoptional

Default value to return if the option does not exist.

Default:`false`

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wp_customize_widgets/get_captured_option/?output_format=md#return)󠁿

 mixed Value set for the option.

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

    ```php
    protected function get_captured_option( $option_name, $default_value = false ) {
    	if ( array_key_exists( $option_name, $this->_captured_options ) ) {
    		$value = $this->_captured_options[ $option_name ];
    	} else {
    		$value = $default_value;
    	}
    	return $value;
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-customize-widgets.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/class-wp-customize-widgets.php#L2106)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/class-wp-customize-widgets.php#L2106-L2113)

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

| Used by | Description | 
| [WP_Customize_Widgets::call_widget_update()](https://developer.wordpress.org/reference/classes/wp_customize_widgets/call_widget_update/)`wp-includes/class-wp-customize-widgets.php` |

Finds and invokes the widget update and control callbacks.

  |

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

| Version | Description | 
| [4.2.0](https://developer.wordpress.org/reference/since/4.2.0/) | Introduced. |

## User Contributed Notes

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