# Organizations

> Share runners with your team, assign roles, invite members and switch between organizations.

Source: https://managerunners.com/docs/manual/organizations/

Runners, schedules, monitoring data and the plan belong to an *organization*. Everyone in an organization sees the same runners, and the organization's plan applies to all of them.

## Your default organization

When you register, Manage Runners creates an organization for you and makes you its owner. It is your *default organization*: the dashboard selects it after you sign in, and the CLI and API use it when no other organization is selected.

## Switch and create organizations

The organization menu at the top of the dashboard lists your organizations with your role in each. Select one to switch; the dashboard then shows that organization's runners.

To create one, select **Create organization** in the menu and enter a name of up to 100 characters. You become its owner. A new organization starts without a plan, so its owner has to choose one under **Billing** before its runners can be used.

## Roles

| Role | Can |
| --- | --- |
| Owner | Everything, including billing, members and invitations. |
| Editor | Create, change, pause and delete runners and schedules. |
| Viewer | See runners, their status and metrics. No changes. |

Each organization has exactly one owner: the person who created it. The owner role cannot be given to someone else, and the owner cannot leave the organization.

Editors can also see the SSH keys available to a runner's Hetzner token, because they edit runners. Viewers see the dashboard without any runner actions.

## Organization settings

Select **Organization** in the sidebar.

![Organization settings with members and a pending invitation](https://managerunners.com/docs/screenshots/organization-light.webp)

- **Name:** the owner can rename the organization.
- **Your role** and **Plan** show your access and the organization's plan.
- **Members:** the owner can change members between Editor and Viewer, and remove them. A removed member loses access immediately.

## Invite members

Only the owner can invite people.

1. Under **Invitations**, select **Invite member**.
2. Enter the email address and choose **Editor** or **Viewer**.
3. Select **Send invitation**.

The person receives an email with a link. They sign in, or register with that email address, and select **Accept invitation**. The link works once and expires after a week. An invitation can only be accepted by an account with the invited email address.

Pending invitations stay in the list until they are accepted. The owner can **Resend** an invitation, which sends a new link and stops the old one from working, or **Revoke** it.

## Leave an organization

Members other than the owner can leave under **Leave organization**. They lose access immediately; the owner has to invite them again for them to return.

## Organizations in the CLI and API

The CLI and personal access tokens work with your default organization unless you select another one. See [Profiles and organizations](https://managerunners.com/docs/cli/profiles-and-organizations/). A personal access token can never do more than your role in the organization allows. Creating organizations, renaming them, and managing members and invitations are only available in the dashboard.