Skip to main content

People

The People page lists the accounts in your organization. Open it from the sidebar: select Directory, then the People tab. Its own strip has the tabs People, described here, Groups and, for an Org Owner or Org Admin, Access. With only one of them open to you, the strip is hidden.

Anyone who can view users sees the list and each user's details. Creating, changing and deleting users requires the org admin role; without it, the buttons and the ⋯ menus don't appear and every field is read-only.

The list​

The People list: the Search and Status filters, then one row per account with its email, name, group count, a select box and a ⋯ menu

Above the rows, a strip narrows the list; every control is kept in the page's address, so a link to it opens the same view:

ControlWhat it narrows to
SearchAccounts whose name or email contains the text.
StatusActive, Disabled or Invited (not signed in yet, or an invitation still open). All, the default, shows every account.

When nothing matches, the page says Nothing matches these filters and offers Clear filters. An org with no accounts reads No users yet.

The list shows a page at a time. Under it, Previous and Next turn the page, the line beside them says which rows you see, for example 1–50 of 1,204, and Per page shows 25, 50 or 100 rows. Select Email, Name or Groups above the rows to sort by it; select it again to reverse the order.

Each row shows, from left to right:

ItemMeaning
Round markFilled: the person has signed in and activated the account. Hollow: invited, not accepted yet. A disabled account's mark is grey.
EmailThe address the person signs in with. (you) marks your own account. A Disabled tag means the account can't sign in; a Declined tag means the person turned the invitation down; a SCIM tag means your identity provider manages the account, and its next sync overwrites edits made here.
NameThe person's first and last name, or — when neither is set. Left out when no account on the page has a name.
NumberHow many groups the account belongs to, not counting Everyone, which every account holds. Hover it to see them.
SelectA box to tick the row for a bulk action. Requires the org admin role. Hidden beside an open user; on a phone, shown once a pick starts from Select beside Add user (Done ends it) or from the row menu's Select.
⋯The row menu. See Row menu. Requires the org admin role.

Select a row to open that user. See A user's details. When the list narrows, for example beside an open user, it hides Name first, then Groups, so the email stays readable.

Bulk actions​

Tick the box at the end of a row, or the one in the column's heading to tick every row on the page, and a bar appears above the list saying how many are selected. Its actions run on every ticked account at once and report each one that refused, in the server's words; a refused account stays ticked so you can try again. An action that no ticked account can take is greyed with the reason. Your own account is never included.

ActionWhat it does
Enable, DisableLets the accounts sign in again, or stops them. Disable asks first.
DeleteDeletes the accounts after you type their count.
Add to group, Remove from groupUnder ⋯ on the bar: pick a group, then add every ticked account to it or take them out.

On a phone, Enable, Disable and Delete show as icons; hover one to read its name.

Turning the page or changing a filter clears the ticks.

Add a user​

Select Add user. Requires the org admin role. The New user page opens in two steps.

Step 1: Details​

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

FieldMeaning
EmailRequired. The person signs in with this address.
First name (optional), Last name (optional)The person's name.
Send invitation emailOn by default. Emails the person an invitation to join. If they have no password yet, its button opens a page to create one (the link works once, for 7 days).

Select Next.

Step 2: Access​

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

FieldMeaning
GroupsType to find groups and pick any number; the person joins each and holds every role it grants. Everyone isn't offered: every account joins it.
Organization roleNone, Org Owner, Org Admin or Project Maintainer. Org Owner is offered only to an Org Owner. Held on the organization, Project Maintainer lets the person create projects, and they reach only the projects they create.
ProjectsSelect Add project for a row, then pick the project and its Role: Project Maintainer, Project Developer (the default) or Project Viewer. × removes the row.
AccountsSelect Add account for a row, then pick the model account and its Role.

Back returns to step 1 and keeps what you typed. The last button reads Invite when Send invitation email is on, else Create.

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. If email isn't set up, the invitation fails, or the invitation limit is reached, the user is still created; send it again with Resend from the row menu.

The new person shows a hollow round mark until they accept the invitation. Roles you grant apply the moment they accept.

Row menu​

Select ⋯ on a row. Requires the org admin role.

A row menu on your own account: Add membership, one Revoke item per group with Revoke Everyone greyed, Select, and Delete greyed

ItemWhat it does
Add membershipAdds the account to a group. Type to find the Group, then select Add.
Revoke groupOne item per group the account belongs to, with the membership's scope in brackets when it has one. Removes the account from that group at once. Revoke Everyone is greyed: every user of the org belongs to it.
ResendShown while the invitation is waiting. Sends the invitation email again. Greyed out for a disabled account.
ReinviteShown in place of Resend when the person declined. Sends a new invitation.
Select, DeselectTicks the row for a bulk action, or clears its tick, the same as its box.
DeleteDeletes the account and all its group memberships, after you confirm. Greyed out for your own account. Deleting the last admin is refused with the reason.

To manage groups themselves, use the Groups tab.

A user's details​

Select a row to open the user. The tabs are Profile, Access, Check, Settings and Notifications. Access and Check appear only on your own account, or if you have the org admin role. Tabs that don't fit the strip's one row sit under More.

Profile and Settings share one bar under the tab, with Cancel and Save. Save is greyed until something changes, then saves the changes on both tabs at once; Saved. appears beside it when they land. Cancel returns to the People list without saving. Notifications saves each box as you change it. On Access, Check and Notifications the bar shows only while a change on the other tabs is waiting. Without the org admin role the bar holds only Back.

The page's save bar: Cancel and Save

Profile​

The Profile tab on your own account: Email with its Contact Support hint, First name, Last name, Description, Set new password, Git Access with its hint, then the dates and who created and updated it

FieldMeaning
EmailThe sign-in address. You can't change your own; contact Support to change it. A locked address wraps, so it shows whole.
First name, Last nameThe person's name — what Jaah shows for this account everywhere (Created by, Assigned to, Answered by, @mentions). With neither set, the email is shown.
DescriptionFree text about the account.
Set new passwordA new password for the account; it also forgets every trusted device. Leave it blank to keep the current one.
Git AccessThe stored credential that tasks started from this account push with. Left empty, pushes from this account are refused, as the hint below it says. With no GitHub or GitLab credential to pick, the hint links to Secrets to add one.
Created, Activated, Last seenWhen the account was created, first activated, and last used.
Created by, Updated byWho created the account and who last changed it; one Created and updated by when it's the same person.

Account and two-factor​

Below the profile, a second section shows the account's state. Its buttons act at once, without Save. Requires the org admin role.

The Account section on your own account: Active, Disable account greyed with the reason, and Two-factor Off

  • Account: Active, Disabled with who disabled it and when, Invited — hasn't accepted yet, or Declined the invitation.
    • Disable account signs the person out and stops them signing in, after you confirm.
    • Enable account lets them sign in again.
    • You can't disable your own account: the button is greyed with the reason.
  • Two-factor: On or Off. When it's on, Reset two-factor makes the person set it up again at their next sign-in and ends their sessions. It isn't offered on your own account.
  • SSO link: shown once the person has signed in through your organization's identity provider, as Linked to an identity provider account. Reset SSO link clears it after you confirm, so whoever next signs in with this email is linked. Use it only when the person's identity provider account changed. It isn't offered on your own account.

Access​

What the user holds, and how they got it.

The Access tab on your own account: Grant access, the Groups field with two groups, then Org Admin held Via group, and on each project the Project Developer role held Via group with Org Admin Inherited from the organization

With the org admin role, Grant access comes first. Its Grant access dialog asks for the Type (organization, project or account), the thing itself, and the Role. On the organization the roles are Org Owner, Org Admin and Project Maintainer; Project Developer and Project Viewer are given on a project or account. A project or account role can carry an Expires date, and left blank it reads Never. Grant adds the role.

  • Groups lists the user's groups. Pick a group to add the user to it, or select ✕ on a group to take them out; each change lands at once, without asking first. Under it, a line says the user is also in Everyone, which every member joins. Without the org admin role it is a Member of line instead, shown when the user is in a group.
  • Organization and projects lists each role the user holds, on the organization and on each project. Each role says how they hold it: Direct or Via group name, and Expires with the date when it ends. Each project ends on one muted line naming the organization roles it inherits, Inherited from the organization. With no role anywhere, the tab says No access yet. (No access without the org admin role).
  • Accounts lists the roles the user holds on model accounts, shown once they hold one.
  • Remove on a Direct line takes that role away, after you confirm. Requires the org admin role.
  • A line held Via group or Inherited from the organization can't be changed here. Change it on the group or the organization.

Check​

Asks whether the user may do one thing, and why.

The Check tab: Type, Organization, Action and Check

ItemMeaning
TypeThe kind of thing to ask about, for example Organization; a second picker names the thing itself.
ActionWhat the user would do there.
CheckAsks. The answer says whether it's allowed, and the chain of roles and groups that allows it, or what's missing.

See Check what someone can access.

Settings​

The Settings tab: Theme

The same settings as your own: see Settings.

Changing them requires the org admin role.

Notifications​

Where this user's alerts go, and which ones: Channels lists their channels, and Alerts each type of alert with a box per channel.

Another user's Notifications tab: their Channels with Add channel, then each type of alert with a box per channel

It works as your own Alerts tab, with these differences:

  • Add channel lists every option greyed out, most with Only they can add channels: each person adds and confirms their own email addresses, Slack and Telegram.
  • An Unverified email shows no Confirm or Resend: only its owner confirms it.
  • Alert names read "to them" in place of "to you", such as Assigned to them.
  • With the org admin role you can tick or untick any box, and select Remove in a channel's ⋯ menu to take it away. Without it, every box shows a padlock and can't change, and Add channel is greyed out.