---
title: "Organizations"
description: "Learn how to manage organizations in Shorebird"
---

Organizations are a way to share groups of apps with people. This is useful for any team collaborating across a company to have access as needed to releases, patches, and more.

## Account requirements

[Section titled “Account requirements”](#account-requirements)

Shorebird’s paid plans unlock features for collaborating with your peers. Shorebird’s free plan users can upgrade to a paid plan to access these features via the account settings page in the [Shorebird console](https://console.shorebird.dev/account).

If you do not see the plan you’re expecting, please reach out to <contact@shorebird.dev> for help.

## Creating an organization

[Section titled “Creating an organization”](#creating-an-organization)

To create an organization, visit the Shorebird console and click on your email address in the bottom left corner. From there, click the ”+” button next to “Organizations”.

![Screenshot of where to start the creation of an organization in the Shorebird Console](/_astro/create_org.JpCiN3ud_Z1Auwr8.webp)

This will automatically create a new organization called “My Organization”. You can head over to the organization’s settings to change its details, including the name.

![Screenshot of how to get to Organization settings in the Shorebird Console](/_astro/access_org_settings.DixQkm0k_Z1qArFu.webp)

## Managing apps

[Section titled “Managing apps”](#managing-apps)

Organizations can have multiple apps associated with them. You can either transfer existing apps to an organization or create new apps within the organization directly.

### Create a new app

[Section titled “Create a new app”](#create-a-new-app)

To create a new app within an organization, select the organization when running `shorebird init`:

![Screenshot of doing \`shorebird init\` command and selecting an organization](/_astro/init_with_org.Cl7Xk5kC_ZHmcBj.webp)

### Transfer an app

[Section titled “Transfer an app”](#transfer-an-app)

To transfer an existing app to an organization, visit the app’s settings and click the “Transfer” button besides “Transfer Ownership” section. You can then select the organization you want to transfer the app to from the dropdown. You can only transfer to an organization you are part of.

![Screenshot of dialog for transferring app to a different org in the Shorebird Console](/_astro/transfer_app_to_different_org.DJXdNqUZ_ZxX8e7.webp)

## Managing members

[Section titled “Managing members”](#managing-members)

### Add a member

[Section titled “Add a member”](#add-a-member)

[Adding Members to the Organization](https://app.arcade.software/share/Cl6LTDv4A3TKhJJOdJse)

To add one or more members to your organization, visit the organization’s settings, go to “Members” section and click the “Invite Member” button.

![Screenshot of how to get to add a member to an Organization in the Shorebird Console](/_astro/add_member_to_org.Bj0_My54_Z14svmU.webp)

You can also edit a member’s role or remove them from the organization from the same members page.

![Screenshot of successfully adding a member to an Organization in the Shorebird Console](/_astro/completed_add_member_to_org.fd3pQj1u_1xNTMW.webp)

### Remove a member

[Section titled “Remove a member”](#remove-a-member)

You can easily remove a member from an organization via the organization’s settings page. Locate the member you wish to remove, click the Trash icon, and confirm the action.

## Member roles

[Section titled “Member roles”](#member-roles)

Organization roles apply to all apps within the organization and can be managed via the organization settings page in the Shorebird console. The roles available to you are based on the plan that you have.

|             | Free | Pro | Business | Enterprise |
| ----------- | ---- | --- | -------- | ---------- |
| Viewer      |      |     | ✅        | ✅          |
| Developer   |      | ✅   | ✅        | ✅          |
| App Manager |      |     |          | ✅          |
| Admin       |      | ✅   | ✅        | ✅          |
| Owner       |      | ✅   | ✅        | ✅          |

### Viewer

[Section titled “Viewer”](#viewer)

Read-only access for stakeholders who need visibility into apps, releases, and patches without the ability to make changes. Ideal for product managers, QA, support, or leadership teams.

### Developer

[Section titled “Developer”](#developer)

Hands-on role for engineers actively building and shipping apps. Can create releases and patches, promote patches, and manage day-to-day development workflows without administrative access.

### App manager

[Section titled “App manager”](#app-manager)

Responsible for managing application lifecycle and release strategy. Has all Developer capabilities plus elevated control over app-level configuration, environments, and release coordination.

### Admin

[Section titled “Admin”](#admin)

Administrative role for managing team access and organization-level settings. Can configure apps, manage users and roles, and handle most operational tasks, excluding billing and plan changes.

### Owner

[Section titled “Owner”](#owner)

Full control over the organization. Can manage billing and plans, ownership settings, and all platform capabilities. Intended for primary account holders.

## Billing & ownership

[Section titled “Billing & ownership”](#billing--ownership)

Each organization has a single owner. An organization’s plan is determined by its [owner’s](#owner) subscription. Their Shorebird subscription is what sets the plan and available features for the entire organization.

To manage billing, the organization owner can visit the [billing settings](https://console.shorebird.dev/account) in the Shorebird console. See [Billing](/account/billing) for more details.

## Managing per app collaborators

[Section titled “Managing per app collaborators”](#managing-per-app-collaborators)

Per-app collaborators can also be added and managed via the Shorebird console. The same management and permissions structure of organizations applies to collaborators, just at a per-app level.

To add a collaborator, from your app’s page:

1. Select the “Collaborators” tab.
2. Click “Invite Collaborator”.
3. Enter the email address of the person you would like to add as a collaborator. Note that the email address must be associated with an existing Shorebird account.
4. Click “Send Invitation”.

Existing collaborators can be removed by clicking the trash icon next to their email address.