handbook/commands/cap.md
github-actions[bot] ff2a543077 Regenerate handbook
2026-07-21 08:35:57 +00:00

22 lines
768 B
Markdown

# wp cap
Adds, removes, and lists capabilities of a user role.
See references for [Roles and Capabilities](https://wordpress.org/documentation/article/roles-and-capabilities) and
[WP User class](https://developer.wordpress.org/reference/classes/wp_user).
### EXAMPLES
# Add 'spectate' capability to 'author' role.
$ wp cap add 'author' 'spectate'
Success: Added 1 capability to 'author' role.
# Add all caps from 'editor' role to 'author' role.
$ wp cap list 'editor' | xargs wp cap add 'author'
Success: Added 24 capabilities to 'author' role.
# Remove all caps from 'editor' role that also appear in 'author' role.
$ wp cap list 'author' | xargs wp cap remove 'editor'
Success: Removed 34 capabilities from 'editor' role.