Title: delete_user_setting
Published: April 25, 2014
Last modified: April 28, 2025

---

# delete_user_setting( string $names ): bool|null

## In this article

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

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

Deletes user interface settings.

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

Deleting settings would reset them to the defaults.

This function has to be used before any output has started as it calls `setcookie()`.

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

 `$names`stringrequired

The name or array of names of the setting to be deleted.

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

 bool|null True if deleted successfully, false otherwise.
 Null if the current user
is not a member of the site.

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

    ```php
    function delete_user_setting( $names ) {
    	if ( headers_sent() ) {
    		return false;
    	}

    	$all_user_settings = get_all_user_settings();
    	$names             = (array) $names;
    	$deleted           = false;

    	foreach ( $names as $name ) {
    		if ( isset( $all_user_settings[ $name ] ) ) {
    			unset( $all_user_settings[ $name ] );
    			$deleted = true;
    		}
    	}

    	if ( $deleted ) {
    		return wp_set_all_user_settings( $all_user_settings );
    	}

    	return false;
    }
    ```

[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#L1798)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/option.php#L1798-L1819)

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

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

Retrieves all user interface settings.

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

Private. Sets all user interface settings.

  |

| Used by | Description | 
| [default_password_nag_handler()](https://developer.wordpress.org/reference/functions/default_password_nag_handler/)`wp-admin/includes/user.php` |  | 
| [default_password_nag_edit_user()](https://developer.wordpress.org/reference/functions/default_password_nag_edit_user/)`wp-admin/includes/user.php` |  |

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

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

## User Contributed Notes

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