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

---

# get_user_setting( string $name, string|false $default_value = false ): mixed

## In this article

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

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

Retrieves user interface setting value based on setting name.

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

 `$name`stringrequired

The name of the setting.

`$default_value`string|falseoptional

Default value to return when $name is not set.

Default:`false`

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

 mixed The last saved user setting or the default value/false if it doesn’t exist.

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

    ```php
    function get_user_setting( $name, $default_value = false ) {
    	$all_user_settings = get_all_user_settings();

    	return isset( $all_user_settings[ $name ] ) ? $all_user_settings[ $name ] : $default_value;
    }
    ```

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

## 󠀁[Related](https://developer.wordpress.org/reference/functions/get_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.

  |

| Used by | Description | 
| [WP_Screen::render_view_mode()](https://developer.wordpress.org/reference/classes/wp_screen/render_view_mode/)`wp-admin/includes/class-wp-screen.php` |

Renders the list table view mode preferences.

  | 
| [WP_Comments_List_Table::handle_row_actions()](https://developer.wordpress.org/reference/classes/wp_comments_list_table/handle_row_actions/)`wp-admin/includes/class-wp-comments-list-table.php` |

Generates and displays row actions links.

  | 
| [WP_MS_Users_List_Table::prepare_items()](https://developer.wordpress.org/reference/classes/wp_ms_users_list_table/prepare_items/)`wp-admin/includes/class-wp-ms-users-list-table.php` |  | 
| [WP_Screen::show_screen_options()](https://developer.wordpress.org/reference/classes/wp_screen/show_screen_options/)`wp-admin/includes/class-wp-screen.php` |  | 
| [WP_List_Table::get_table_classes()](https://developer.wordpress.org/reference/classes/wp_list_table/get_table_classes/)`wp-admin/includes/class-wp-list-table.php` |

Gets a list of CSS classes for the [WP_List_Table](https://developer.wordpress.org/reference/classes/wp_list_table/) table tag.

  | 
| [WP_List_Table::row_actions()](https://developer.wordpress.org/reference/classes/wp_list_table/row_actions/)`wp-admin/includes/class-wp-list-table.php` |

Generates the required HTML for a list of row action links.

  | 
| [default_password_nag_handler()](https://developer.wordpress.org/reference/functions/default_password_nag_handler/)`wp-admin/includes/user.php` |  | 
| [WP_MS_Sites_List_Table::prepare_items()](https://developer.wordpress.org/reference/classes/wp_ms_sites_list_table/prepare_items/)`wp-admin/includes/class-wp-ms-sites-list-table.php` |

Prepares the list of sites for display.

  | 
| [media_upload_type_form()](https://developer.wordpress.org/reference/functions/media_upload_type_form/)`wp-admin/includes/media.php` |

Outputs the legacy media upload form for a given media type.

  | 
| [media_upload_type_url_form()](https://developer.wordpress.org/reference/functions/media_upload_type_url_form/)`wp-admin/includes/media.php` |

Outputs the legacy media upload form for external media.

  | 
| [media_upload_gallery_form()](https://developer.wordpress.org/reference/functions/media_upload_gallery_form/)`wp-admin/includes/media.php` |

Adds gallery form to upload iframe.

  | 
| [media_upload_library_form()](https://developer.wordpress.org/reference/functions/media_upload_library_form/)`wp-admin/includes/media.php` |

Outputs the legacy media upload form for the media library.

  | 
| [media_upload_max_image_resize()](https://developer.wordpress.org/reference/functions/media_upload_max_image_resize/)`wp-admin/includes/media.php` |

Displays the checkbox to scale images.

  | 
| [image_align_input_fields()](https://developer.wordpress.org/reference/functions/image_align_input_fields/)`wp-admin/includes/media.php` |

Retrieves HTML for the image alignment radio buttons with the specified one checked.

  | 
| [image_size_input_fields()](https://developer.wordpress.org/reference/functions/image_size_input_fields/)`wp-admin/includes/media.php` |

Retrieves HTML for the size radio buttons with the specified one checked.

  | 
| [image_link_input_fields()](https://developer.wordpress.org/reference/functions/image_link_input_fields/)`wp-admin/includes/media.php` |

Retrieves HTML for the Link URL buttons with the default link type as specified.

  | 
| [WP_Comments_List_Table::prepare_items()](https://developer.wordpress.org/reference/classes/wp_comments_list_table/prepare_items/)`wp-admin/includes/class-wp-comments-list-table.php` |  | 
| [WP_Posts_List_Table::prepare_items()](https://developer.wordpress.org/reference/classes/wp_posts_list_table/prepare_items/)`wp-admin/includes/class-wp-posts-list-table.php` |  | 
| [wp_default_editor()](https://developer.wordpress.org/reference/functions/wp_default_editor/)`wp-includes/general-template.php` |

Finds out which editor should be displayed by default.

  | 
| [_WP_Editors::parse_settings()](https://developer.wordpress.org/reference/classes/_wp_editors/parse_settings/)`wp-includes/class-wp-editor.php` |

Parse default arguments for the editor instance.

  |

[Show 15 more](https://developer.wordpress.org/reference/functions/get_user_setting/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/get_user_setting/?output_format=md#)

## 󠀁[Changelog](https://developer.wordpress.org/reference/functions/get_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%2Fget_user_setting%2F)
before being able to contribute a note or feedback.