Skip to main content

Invite a person and grant access

A new team member needs two things: an account in your organization, and a role that lets them work. The New user page does both: their details first, then their access.

Who can do this: adding users requires the org admin role. Without it, Add user doesn't appear and the New user page doesn't open.

Add the person and invite them​

Step 1 of the New user page: Email, First name (optional), Last name (optional), Send invitation email, Cancel and Next

  1. In the sidebar, select Directory, then the People tab.
  2. Select Add user. The New user page opens on Details.
  3. Enter the person's Email. They sign in with this address.
  4. If you like, fill in First name (optional) and Last name (optional).
  5. Leave Send invitation email on to email them an invitation.
  6. Select Next.

Step 2 of the New user page: Groups, Organization role, a Projects row with its Role, Add project, Accounts with Add account, and Cancel, Back and Invite

  1. Optional: in Groups, pick the groups they join. They hold every role each group grants.
  2. Optional: pick an Organization role: None, Org Owner, Org Admin or Project Maintainer. Among your organization's members, only an Org Owner is offered Org Owner. Project Maintainer lets them create projects and reach the ones they create.
  3. For each project they work on, select Add project, pick the project, then its Role. Project Developer is picked by default. × removes a row.
  4. For each model account they use, select Add account, pick the account, then its Role.
  5. Select Invite. With Send invitation email off, the button reads Create.

Back returns to Details and keeps what you typed.

The People list opens with a line saying whether the invitation was sent, and naming any role that wasn't granted or group that wasn't joined. The new person shows a hollow round mark until they accept. The roles you picked apply the moment they accept.

The invitation email's button opens a page naming your organization and who invited them. A new person is taken to a page where they type a Password, repeat it in Confirm password, and select Accept invitation, then sign in with it. Someone who already uses Jaah is sent to sign in first if they are signed out, then sees Signed in as their address and selects Join or Decline. The page notes that, once they join, your organization's admins can see their name and email. If joining or declining fails, a red message above the buttons says why. They can also answer from their account menu. Decline shows Invitation declined ("You won't join ."), with Continue. An invitation already answered, withdrawn or sent to another account opens as Invitation unavailable, naming the account they're signed in as, with Go to Jaah and, next to Wrong account?, Sign out.

The Invitation unavailable page: Go to Jaah, and Sign out next to Wrong account?

Joining lands them on your organization's home. If your organization asks for an authenticator code, the page asks for it first: they enter their Authenticator code and select Verify and switch, or Not now to switch later from the account menu. If your organization needs an identity provider's sign-in, the page says so under You joined , and tells them to sign out, then sign in with that provider (or with Sign in with SSO); Continue takes them on. If the switch can't finish there, the page says You joined and why, or asks them to switch to it from the account menu.

If the invitation didn't go out, open the person's ⋯ menu and select Resend. If they declined, their row shows a Declined tag and the menu offers Reinvite.

Grant access later​

Through a group​

The easiest way to give a role: add the person to a group that already holds it.

  1. On the People tab, select ⋯ at the end of the person's row.
  2. Select Add membership.
  3. Pick the Group.
  4. Select Add.
  5. Hover the number in the person's row to check the group is listed.

Every member of your organization is also in the Everyone group, and gets the roles it holds. No group fits? Create a group.

On the person's Access tab​

  1. On the People tab, select the person's row.
  2. Select the Access tab.
  3. To add them to a group, pick it in Groups; it applies at once.
  4. To grant a role, select Grant access, pick the Type (organization, project or account), the thing itself, and the Role, then select Grant.

Remove on a Direct line takes a role away, after you confirm.

On one project​

Alternatively, grant the role from the project.

  1. In the sidebar, select Directory, then the Projects tab.
  2. Select the project's name, then Settings › Access.
  3. Select Grant access.
  4. In Who, pick the person, then pick the Role, for example Project Developer.
  5. Select Grant.

Details and how to take a role away: Give someone access to a project.

Check the result​

Open the person's account and select Access to see every role they hold. See Check what someone can access.

For the roles and an account's states, see How team and access work.