wp role delete

Last updated: February 15, 2026

Deletes an existing role.

Synopsis

bash
wp role delete <role-key>

Options

The internal name of the role.

Examples

bash
# Delete approver role
$ wp role delete approver
Success: Role with key 'approver' deleted.

# Delete productadmin role
$ wp role delete productadmin
Success: Role with key 'productadmin' deleted.

More in Role

wp role create

Creates a new role. Synopsis wp role create <role-key> <role-name> [--clone=<role>] Options The internal name…

wp role exists

Checks if a role exists. Exits with return code 0 if the role exists, 1…

wp role list

Lists all roles. Synopsis wp role list [--fields=<fields>] [--field=<field>] [--format=<format>] Options [--fields=] Limit the output…

wp role reset

Resets any default role to default capabilities. Uses WordPress' populate_roles() function to put one or…

All WP-CLI Docs View all Role
View on GitHub