WordPress.org

Description

Generates a list of editable user roles as options for a select box.

Usage

<?php wp_dropdown_roles( $selected ); ?>

Parameters

$selected

(string) (optional) Slug for the role that should be already selected.

Default: false

Return Values

This function does not return a value. Its output is echo'd directly.

Examples

If you would like to set a default role for the dropdown, provide the slug for the desired role as a parameter. The following example creates a dropdown of user roles with the "Editor" role as the default, selected value:

<select>
   <?php wp_dropdown_roles( 'editor' ); ?>
</select>

Change Log

Since: 2.1.0

Source File

wp_dropdown_roles() is located in wp-admin/includes/template.php

Related

• add_role()
• remove_role()
• get_role()
• add_cap()
• remove_cap()

• get_editable_roles

List & Dropdown Functions

• Function: wp_list_authors()
• Function: wp_list_categories()
• Function: wp_list_pages()
• Function: wp_list_bookmarks()
• Function: wp_list_comments()
• Function: wp_get_archives()
• Function: wp_page_menu()
• Function: wp_dropdown_pages()
• Function: wp_dropdown_categories()
• Function: wp_dropdown_users()
• Function: wp_dropdown_roles()
• Function: wp_dropdown_languages()

Resources

• Get User Roles as Checkboxes