wp role

See references for Roles and Capabilities and WP User class.

EXAMPLES EXAMPLES

# List roles.
$ wp role list --fields=role --format=csv
role
administrator
editor
author
contributor
subscriber

# Check to see if a role exists.
$ wp role exists editor
Success: Role with ID 'editor' exists.

# Create a new role.
$ wp role create approver Approver
Success: Role with key 'approver' created.

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

# Reset existing roles to their default capabilities.
$ wp role reset administrator author contributor
Success: Reset 3/3 roles.

Top ↑

SUBCOMMANDS SUBCOMMANDS

Name Description
wp role create

Creates a new role.

wp role delete

Deletes an existing role.

wp role exists

Checks if a role exists.

wp role list

Lists all roles.

wp role reset

Resets any default role to default capabilities.