How To: Invite Users And Assign Roles

Updated

Give each person on your team their own Foreman login, with a role that controls what they can see and do.

Before You Start

  • You need the Admin role or the Manage Users permission.
  • Decide which roles you need first. Every permission is listed in Quick Guide: Roles And Permissions.
  • Users, roles and service accounts are all on one page: open the user menu (top right) and select Users.

Create a Role

  1. On the Users page, open the Roles tab and click Add Role.
  2. Enter a role name, such as "Site Technician".
  3. If you manage sub-clients, choose whether to Sync Role To Sub-Clients.
  4. Tick the permissions the role needs, and save.

To change a role later, click Edit on its row. Changes apply to everyone with that role.

Invite Users

  1. On the Users tab, click Invite Users.
  2. Enter one or more email addresses, separated by commas, and send.
  3. Each person gets an email invitation. Invitations expire after 3 days, and can only be accepted by a Foreman account registered to the invited email address.
  4. Once they've accepted, assign their role from their row on the Users tab.

Change or Remove Access

  • Change a role: on the Users tab, edit the person's roles.
  • Remove a user: on the Users tab, delete the person's access. Do this as soon as someone leaves.

Review Who Has Access

Use Export Users and Export Roles on the Users page to download CSVs for access reviews. Group owners get every sub-client in one file. To see what people have changed, open the user menu and select Audit Log (needs View Audit Logs).

Common Problems

Symptom Fix
The invitation link doesn't work It may have expired after 3 days. Send a new invite.
The person can't accept the invite They must sign in with a Foreman account that uses the exact email address you invited.
A user can't see a page or button Their role is missing the permission. Check Quick Guide: Roles And Permissions.

Related Articles

Last verified: November 19, 2026

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Can't find what you're looking for?

Our support team can help with setup, hardware and billing questions.

Contact Support