User Roles and Capabilities

User Roles and Capabilities — a practical guide to WordPress roles capabilities with clear examples you can reuse in real projects.

WordPress Plugin Development Series (56/95). Prefer one article? Read the complete WordPress plugin development tutorial.

Short description

Use `add_role` / `get_role()->add_cap()` on activation and remove carefully on uninstall if appropriate.

Add capability

$role = get_role('editor');
if ($role) {
    $role->add_cap('manage_acme_items');
}