Documentation / User Roles and Privileges

User Roles and Privileges

Updated July 28, 2026

The Users tab (Agent Builder → Settings → Users) controls which WordPress roles can administer the plugin and chat with agents, plus daily query and token limits. Administrators always retain full access and unlimited usage.

Settings Users tab with plugin administration matrix, AI agent permissions, daily limits, and permission tooltips
Users — privilege matrices with ? tooltips and daily limits

Request rate limits (per-minute throttles) are on Settings → Security, not Users. Users sits directly above Security in the settings navigation.

Permission tooltips

Each permission row has a ? control. Hover or focus it for a short explanation of what that privilege unlocks — so long descriptions do not clutter the table.

Plugin administration

Who can open and configure Agent Builder admin pages:

PermissionWhat it controls
View DashboardDashboard overview and stats
Manage AgentsInstall, activate, edit, delete agents
View Audit LogActivity / audit log
Configure ToolsEnable or disable tools
Run Tasks ManuallyTrigger scheduled tasks by hand
Manage Plugin SettingsAll settings tabs, providers, keys

AI agent interaction

PermissionWhat it controls
Chat on the FrontendPage embeds and shortcodes (includes visitors when allowed)
Chat in the Admin BarAdmin bar chat overlay
View Installed AgentsBrowse agents list in admin
Use Premium / Uploaded AgentsMarketplace or uploaded assistants

Daily usage limits

Per role (and anonymous visitors): Queries / day and Tokens / day. Use 0 for unlimited. Counters reset at midnight UTC. Administrators are never limited.

How enforcement works

  • Rules apply to admin menu visibility, admin bar chat, REST chat API, and AJAX task triggers.
  • Unchecked roles are blocked at the server, not only hidden in the UI.
  • Removing all plugin privileges from a role hides the Agent Builder menu for that role.

Tips

  • Grant admin-bar chat to Editors for writing help without settings access.
  • Keep Manage Plugin Settings on Administrator for multi-author sites.
  • Tune per-minute abuse protection under Security.

Ready to put this to work?

Agent Builder is free forever — install assistants, connect a provider when you are ready, and stay in control with Approvals.

Download Free Compare Free vs Pro