WP-CLI

A command line interface for WordPress

Commands » role

wp role - Manage user roles.

Quick links: Github issues


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.

SUBCOMMANDS

Name Description
create Create a new role.
delete Delete an existing role.
exists Check if a role exists.
list List all roles.
reset Reset any default role to default capabilities.