For the complete documentation index, see llms.txt. This page is also available as Markdown.

Managing Roles, Groups, and Permissions

How to control who can do what in your Herd workspace using roles, groups, and permissions.


Understanding Roles

Every user in Herd has one of three roles. Your role determines your overall level of access.

Role
Who It's For
Access Level

Admin

Organization owners and security leaders

Full access to everything. Bypasses all permission checks. Can manage users, groups, billing, and integrations.

Operator

Team leads, department heads, training coordinators

Web app access with permissions controlled by group membership. Can only do what their group permissions allow.

Member

Everyone else in your organization

No web app access. Interacts with Herd only through Slack or Teams — completing trainings, responding to simulations, etc.

The first user to log in to a new Herd workspace automatically becomes an Admin. All subsequent users start as Operators and are added to your default group.


Understanding Groups

Groups are how you organize Operators and assign them permissions. Think of groups like teams — each group has a set of permissions, and every Operator in that group inherits those permissions.

  • Each group has a name, description, and a set of permissions

  • An Operator can belong to multiple groups — their permissions are the combined set from all groups

  • New Operators are automatically added to your organization's default group

  • Groups can pull members from Okta, Azure AD, Google Workspace, or Slack to mirror your existing team structure


Setting Up Groups

1. Plan Your Access Structure

Before creating groups, decide who needs access to what.

Keep the default Full Access group. All Operators can do everything. Admins handle user management and settings.

Group
Recommended Template

Security Team — Full phishing, smishing, training, and reporting access

Security Manager

HR / Training Team — Training creation and assignment only

Training Manager

Compliance Team — Compliance campaigns and policies

Compliance Manager

Leadership — Read-only dashboards and reports

Viewer

Create a custom group for each role with only the specific permissions they need. Start with the closest template and remove permissions you don't want to grant.

2. Create a Group

1

Open Group Settings

Go to Settings in the left sidebar, then click Groups.

2

Create the Group

Click Create Group, then give it a name and description.

3

Choose a Template

Select a permission template as a starting point, or build from scratch.

4

Adjust Permissions

Add or remove individual permissions as needed for this group.

5

Add Members

Add individual users or connect synced identity provider groups.

3. Update Your Default Group

If you don't want new users to automatically have full access:

  1. Go to Users → Groups

  2. Edit the default group's permissions (e.g., change it to Viewer-only)

  3. Or create a new limited-permission group and set it as the default under Default Group for New Users — the gear icon on the Users page


Permission Reference

Admins always have all permissions. The tables below apply to Operators.

Permission
What It Allows

View trainings

See all trainings in your organization

Create trainings

Build new trainings (manual or AI-generated)

Edit trainings

Modify existing trainings

Delete trainings

Remove trainings permanently

Assign trainings

Send trainings to employees via Slack or Teams

Approve trainings

Review and approve pending trainings before they go live

Permission
What It Allows

View tracks

See all learning tracks

Create tracks

Build new multi-training tracks

Edit tracks

Modify existing tracks

Delete tracks

Remove tracks

Assign tracks

Assign tracks to employees

Permission
What It Allows

View phishing

See phishing campaigns and results

Manage templates

Create, edit, and delete phishing email templates

Approve templates

Review and approve phishing templates

Manage campaigns

Create, launch, pause, and delete phishing campaigns

Permission
What It Allows

View smishing

See SMS simulation campaigns and results

Manage templates

Create, edit, and delete SMS templates

Approve templates

Review and approve SMS templates

Manage campaigns

Create, launch, pause, and delete SMS campaigns

Permission
What It Allows

View compliance

See compliance campaigns and status

Manage compliance

Create, edit, and run compliance campaigns

View policies

See all policies

Manage policies

Create, edit, delete, and publish policies

Permission
What It Allows

View dashboard

Access the reporting dashboard with charts and summaries

View risk scores

See individual employee risk scores

Permission
What It Allows

Manage gamification

Configure leaderboards and points (gamification.manage)

Permission
What It Allows

View AI Coach

Access the AI Coach section and view conversation scores (ai_governance.view)

Manage AI Coach

Configure AI Coach settings, connections, and remediation (ai_governance.manage)

These permissions gate the AI Coach section. AI Coach is currently in beta and enabled per organization.

Permission
What It Allows

View GitHub integration

View GitHub integration data (github_integration.view)

Manage GitHub integration

Configure the GitHub integration (github_integration.manage)

The GitHub integration is in beta.

Permission
What It Allows

View users

See the user list and profiles

Manage users

Add, edit, and deactivate users

View groups

See group configurations

Manage groups

Create, edit, and delete groups and their permissions

Permission
What It Allows

Organization settings

Modify organization-level settings (name, branding, SMS)

Integrations

Configure Slack, Teams, Okta, Azure AD, and other integrations

Permissions settings

Configure organization-wide permission defaults


Permission Templates

Templates are pre-built permission sets that make group setup faster. Use them as a starting point — you can add or remove individual permissions after applying one.

Template
Best For
Includes

Training Manager

HR teams, L&D coordinators

View, create, edit, delete, and assign trainings

Training Reviewer

Managers who approve content

View and approve trainings

Security Manager

Security team leads

Full training, phishing, smishing, tracks, reporting, and gamification access

Compliance Manager

Compliance officers, GRC teams

Compliance campaigns, policies, and dashboard access

Viewer

Leadership, auditors

Read-only access to all content, dashboards, users, and groups (also includes AI Coach view and GitHub integration view)

Full Access

Small teams, power users

All permissions — equivalent to Admin, but still governed by group membership


Ownership Scoping

When Operators create trainings, campaigns, or other content, that content is owned by their group.

  • Operators can only edit and delete content owned by groups they belong to

  • Operators can view content from other groups if they have the relevant view permission

  • Admins can see and manage all content regardless of ownership

This prevents department heads from accidentally modifying each other's work while still allowing visibility across the organization.


Common Questions

Can an Operator give themselves more permissions?

No. Only users with the Manage Groups permission can change group permissions, and they can only modify groups — not grant themselves Admin access. Only an Admin can promote someone to Admin.

What happens when I remove someone from a group?

They immediately lose that group's permissions. If they belong to other groups, they keep those permissions. If removed from all groups, they have no permissions and will see an empty dashboard.

Can I sync groups with my identity provider?

Yes. Groups can pull members from Okta, Azure AD, Google Workspace, and Slack. When someone is added or removed in your IdP, their Herd permissions update automatically.

What's the difference between an Admin and an Operator with Full Access?

Functionally very similar, but Admins can: promote or demote other Admins, manage billing, impersonate users for troubleshooting, and their access can never be restricted by group changes. An Operator with Full Access can lose permissions if their group is modified.

How do I restrict the default group?

Go to Users → Groups, edit the default group, and change its permissions to something more restrictive (e.g., Viewer). To change which group is the default, use the gear icon on the Users page. All future new users will receive these limited permissions instead of full access.

I accidentally locked myself out. What do I do?

Ask another Admin in your organization to restore your group membership. If no other Admins are available, contact Herd support.


Best Practices

Last updated