Members and roles
Each member of an organization has one role. Higher roles can do everything the lower ones can.
| Viewer | Developer | Admin | Owner | |
|---|---|---|---|---|
| See projects, apps, deployments, logs and activity | ✓ | ✓ | ✓ | ✓ |
| See environment variable names | ✓ | ✓ | ✓ | ✓ |
| Create and edit projects and applications | ✓ | ✓ | ✓ | |
| Deploy, redeploy and roll back | ✓ | ✓ | ✓ | |
| Manage environment variables and domains | ✓ | ✓ | ✓ | |
| Delete projects and applications | ✓ | ✓ | ||
| Rename the organization | ✓ | ✓ | ||
| Connect or disconnect GitHub | ✓ | ✓ | ||
| Invite members and change their roles (except owners) | ✓ | ✓ | ||
| Grant, change or remove the owner role | ✓ |
Nobody, including owners, can read an environment variable’s value after it’s saved.
Choosing a role
Section titled “Choosing a role”- Viewer: someone who needs to check status or logs without changing anything, such as a client or support colleague.
- Developer: people who build and ship the apps. This is the right role for most of your team.
- Admin: team leads who manage people, settings and the GitHub connection.
- Owner: the organization’s accountable people. Keep at least two, so access never depends on one person.
Invite someone
Section titled “Invite someone”- Go to Settings → Team members and use Invite someone.
- Enter their email address and choose a role.
- They receive an email with a link. They sign in, or create an account, with that same email address and join straight away.
Invitations expire after 7 days. Under Pending invitations you can send a new link (the previous one stops working) or Cancel invite.
Change a role or remove a member
Section titled “Change a role or remove a member”On Settings → Team members, change a member’s role or remove them. Admins can manage everyone except owners. Only owners can make someone an owner, or change or remove an owner.
An organization always keeps at least one owner, so the last owner can’t leave or be demoted.
Leave an organization
Section titled “Leave an organization”On Settings → Team members, find your own row and choose Leave organization. If you’re the only owner, make someone else an owner first.
Good practice
Section titled “Good practice”- Give people the lowest role that lets them do their work.
- Remove people as soon as they leave the team or a project ends.
- Review the activity log from time to time for unexpected changes.