| 1 | --- |
| 2 | title: People and teams |
| 3 | description: Find anyone in a workspace, see their teams and what they own, and edit a profile's title and ownership. |
| 4 | --- |
| 5 | |
| 6 | **People** is where a workspace's people are listed: who they are, the |
| 7 | teams they are on and what they own. Open it from **People** at the foot |
| 8 | of the rail. Its sidebar has: |
| 9 | |
| 10 | | Page | Address | What it is | |
| 11 | | --- | --- | --- | |
| 12 | | **Everyone** | `g1t.sh/<workspace>/-/people` | The [directory](#the-directory) of the workspace's people. | |
| 13 | | **Teams** | `g1t.sh/<workspace>/-/teams` | The workspace's [teams](/guides/teams/). | |
| 14 | |
| 15 | Only members of the workspace can open these pages. Who belongs, and |
| 16 | inviting people, is the workspace's own business: **Members**, |
| 17 | **Invitations** and **Permissions** are under **Workspace → Access**; see |
| 18 | [members, invitations and permissions](#members-invitations-and-permissions). |
| 19 | |
| 20 | ## The directory |
| 21 | |
| 22 | The directory, `g1t.sh/<workspace>/-/people`, lists the workspace's |
| 23 | people, with one search box and how many there are. |
| 24 | |
| 25 | 1. Open **People**, then **Everyone**. |
| 26 | 2. Type in **Name, title, team or what they own**. |
| 27 | |
| 28 | The search matches a person's name, username, title, teams, what they |
| 29 | own, location and bio. The address keeps the search, so you can share it: |
| 30 | `?q=billing`. |
| 31 | |
| 32 | Each card shows: |
| 33 | |
| 34 | - the person's picture with a dot for whether they are around; |
| 35 | - their name and title; |
| 36 | - their teams; |
| 37 | - their local time, from the time zone on their |
| 38 | [profile](https://g1t.sh/settings/profile); |
| 39 | - what they own. |
| 40 | |
| 41 | Owners see **Invite people**, which opens the workspace's |
| 42 | [Members](#members-invitations-and-permissions) page, where **Invite** is. |
| 43 | |
| 44 | ## A person's profile |
| 45 | |
| 46 | Choose someone in the directory to open their profile, |
| 47 | `g1t.sh/<workspace>/-/people/<username>`. It shows their title, username, |
| 48 | pronouns, whether they are around and their status, location and local |
| 49 | time, their bio and what they own. Their name, pronouns, bio, location and |
| 50 | time zone come from their account's |
| 51 | [profile settings](/guides/authentication/); their title and what they own |
| 52 | are set for this workspace. |
| 53 | |
| 54 | | Card | What it shows | |
| 55 | | --- | --- | |
| 56 | | **Teams** | The teams they are on, with **Lead** or **Maintainer** beside each where it applies. | |
| 57 | | **Access** | **Code**: their role on the workspace's repositories, such as *Admin on every repository, as an owner* or *Read on every repository, the workspace's base permission*, then any roles through teams, such as *Roles on 3 repositories through Backend*. **Storage**: coming. | |
| 58 | |
| 59 | **Message** opens your direct message with them in [Chat](/guides/chat/). |
| 60 | |
| 61 | ### Edit a profile |
| 62 | |
| 63 | You can edit your own profile; owners can edit anyone's. |
| 64 | |
| 65 | 1. Open the profile, `g1t.sh/<workspace>/-/people/<username>`. |
| 66 | 2. Choose **Edit profile**. |
| 67 | 3. Change what you need, and save. |
| 68 | |
| 69 | | Field | Who sets it | Limits | |
| 70 | | --- | --- | --- | |
| 71 | | **Title** | The person, or an owner | Their job here, such as *Staff Engineer*. Up to 80 characters. | |
| 72 | | **What they own** | The person, or an owner | One per line: a product, a process, an account. Up to 8, each up to 60 characters. Repeats are left out. | |
| 73 | |
| 74 | What you set here is shown in the directory and on their profile. Each |
| 75 | change is recorded in the workspace's [audit log](/guides/audit-log/) as |
| 76 | `member.profile_edited`. |
| 77 | |
| 78 | When someone leaves the workspace, any team they led has no lead. |
| 79 | |
| 80 | ## Members, invitations and permissions |
| 81 | |
| 82 | Who is in the workspace is a setting of the workspace, so it lives in |
| 83 | [Workspace mode](/guides/workspaces/#workspace-mode), under **Access**: |
| 84 | |
| 85 | | Page | Address | What it is | |
| 86 | | --- | --- | --- | |
| 87 | | **Members** | `g1t.sh/<workspace>/-/members` | Everyone in the workspace and their roles, with search and filters; **Invite** (a dialog), changing roles, transferring ownership, outside collaborators and leaving. See [add people](/guides/workspaces/#add-people) and [change someone's role](/guides/workspaces/#change-someones-role). | |
| 88 | | **Invitations** | `g1t.sh/<workspace>/-/members/invitations` | Every invitation to join, by where it stands: pending, accepted, declined, expired, revoked. Owners only. | |
| 89 | | **Permissions** | `g1t.sh/<workspace>/-/permissions` | Who may do what, part by part, [the base permission](/guides/access-and-roles/#the-base-permission) included. Owners only. See [permissions](/guides/permissions/). | |
| 90 | |
| 91 | ## Next |
| 92 | |
| 93 | - [Teams](/guides/teams/): roles on repositories, mentions, review |
| 94 | requests, and a team's lead and channel. |