Roles¶
If you’re already using Zammad, you’ll know that users can be admins, agents, or customers. These are Zammad’s built-in roles, and they’re the tip of the iceberg of its powerful, flexible, and fine-grained permission system.
Tip
💡 LDAP/Active Directory users:
Syncing your LDAP “groups” to Zammad roles can make access management way easier. To learn more, see LDAP / Active Directory.
What Is a Role?¶
Some users can do things others can’t (like close a ticket). Users have roles, roles have permissions, and permissions are what make those actions possible. You can think of roles as a kind of a collection of permissions.
So what exactly are permissions, then?
Simply put, permissions are names for all the different things users might want to do throughout the system, such as:
chat.agent
: respond to live chat messages
ticket.agent
: update tickets
admin.user
: access the Manage > Users admin panel
knowledge_base.editor
: create/edit knowledge base articles
Zammad has dozens of these permissions, which is a lot to keep track of. So instead of assigning a bunch of permissions to different users, the idea is to assign permissions to roles. And each user has an assigned role.
This makes creating user accounts for new agents a whole lot simpler, and it also makes it easier to assign a new permission to a role and say “All existing agents can do that now, too.”
In short, roles are just collections of permissions that you can give to a user. The built-in admin, agent, and customer roles are enough for many teams, but Zammad gives you the freedom to custom-build your own.
And to do that, you’ll need to know what each permission does.
Note
Users can have both “agent” and “customer” roles at the same time!
Why would you want this? Agents get overviews of all the tickets they’re assigned to (among others), while customers get an overview of all the tickets they’ve opened. But some teams use Zammad for both internal and public communication, so their agents need both.
Having both roles also changes what you see in the ticket view, depending on whether you’re the “customer” or not.
Reference Guide: Permissions¶
Broadly speaking, there are four types of permission groups. Click on each to
go to the detailed list of granular permissions. You can either select the whole
permission group (e.g. admin
) or a subset of it
(e.g. admin.text_module
).
- 🛡️ Admin
For access to each page of the admin panel
- 🕵️ Agent
For access to customer communications
- 👤 Customer
Without the
ticket.customer
permission, customers can’t see the My Ticket overview—but they can still log in and open new tickets!- 🎛️ User Preferences
For access to your own user profile
Role Details¶
- Default at Signup
Every new user must be assigned at least one role upon creation. This attribute decides which role to give new users by default (which usually happens when creating a new ticket for a new customer).
Warning
🙅 Default roles should never provide admin/agent permissions.