HomeGuidesReferenceLearn
ArchiveExpo SnackDiscord and ForumsNewsletter

Account types

Learn about the different types of Expo accounts and how to use them.


An Expo account is a container that holds Expo projects and allows for different amounts of collaboration. There are two types of Expo accounts: Personal, and Organization.

The type of account you choose to put a new project depends on the nature of the project. If you are looking to collaborate or set up a workflow for your development team, always create an Organization account. For personal or hobby projects, a Personal account is sufficient.

Personal accounts

When you sign up for an account with Expo, a Personal account is automatically created for you. This account is a good place to work on your personal projects.

Do not share authentication credentials for your Personal account with anyone for any reason.

Organizations

An Organization account is best used to hold projects that you wish to share with other members of a company or a group of developers. It serves as a shared container where your team can collaborate on one or multiple projects and have access to shared credentials.

You can invite other members to your Organization account, and then give these members different roles that grant a level of access within the organization. For more information, see role privileges in Manage access.

Creating an organization account is useful when:

  • You think you may need to transfer control of that Organization's projects in the future.
  • Sharing one or multiple projects with a team of collaborators.
  • More than one Owner needs to be assigned.
  • Expenses need to be isolated.
  • Granting different levels of access by assigning a role to each member of the organization.
  • Structuring projects for different contexts. For example, when working for different clients, a new organization may be created for each client.
  • Sharing an EAS Subscription.

Create a new Organization

If you are logged in to your Personal account, you can create a new Organization from the dashboard:

  • Select your account's username in the navigation menu to open the dropdown menu.
  • Select Create Organization under Organizations in the dropdown menu.
  • Add a name for your Organization and select the Create button.

After creating a new Organization, you are redirected to the new dashboard page for the organization. To associate a new project with the Organization, you have to add the owner key under the expo key to your project's app.json.

Convert a Personal account into an Organization

You can convert your Personal account into an Organization when you want to share access to projects with other members and assign each member a role-based privilege.

From the User settings of your Personal account, go to Convert your account into an organization section to start the process.

When you are going through this process, we take a lot of care to make sure that all of the functionality that you and your users rely on will continue to work as expected:

  • You can continue to deliver updates and push notifications to your users.
  • You can still use any Android or iOS credentials stored on Expo's servers.
  • Any integrations using your personal access token or webhooks will continue to operate and are transferred to the new designated owner.
  • Your EAS subscription will continue without interruption.
  • Your production apps will continue to operate without interruption.

The Organization account will adopt your old username. Converting a Personal account into an Organization account requires you to designate a new user as the owner of the Organization account. You will have the opportunity to designate an existing user or sign up as a new user during the account conversion process.

The example below is Step 3 in the conversion process on a Personal account with the username:

After completing the conversion process, you can no longer log in as your old user. To continue using Expo services, log into expo.dev with the user you selected or created during the conversion process. Then, select the Organization from the navigation dropdown to access the organization.

Invite a member

Other Expo users can be invited to join your Organization. To invite a new member:

  • Navigate to Members under Organization settings in the Expo dashboard.
  • Click the button Invite. This will open a form to invite a member to the organization.
  • In the form, enter the email of the user you want to invite and select the role they should have upon joining the organization. For more information, see role privileges in Manage access.

When inviting a new member, keep in mind:

  • Only members with an Owner or an Admin role can invite others.
  • Members with an Owner role can grant members and invitees any role.
  • Members with an Admin role can only give members and invitees up to and including Admin role (every role but Owner).

Change the role of a member

To change the role privileges of a member, make sure you have either an Owner or Admin role and follow the steps below:

  • Navigate to Members under Organization settings in the Expo dashboard.
  • Next to the member whose role you want to change, click on the three-dotted menu icon and change the role.

Remove a member

To remove a member, make sure you have either an Owner or Admin role and follow the steps below:

  • Navigate to Members under Organization settings in the Expo dashboard.
  • Next to the member you want to remove, click on the three-dotted menu icon.
  • Click Remove member.

Rename an account

Accounts can be renamed a limited number of times. Only Owners can rename accounts. To rename an account, visit the account settings and follow the steps under Rename account.

Transfer projects between accounts

Projects can be transferred a limited number of times. A user must be an Owner or Admin on both source and destination accounts to transfer projects between them. Visit the project settings page and follow the steps under Transfer project.

Caveats

Before transferring a project, make sure that it is on Expo SDK 43 or above. If not, you must upgrade it and rebuild it for OTA updates to continue to work on that project.

If you want to transfer the ownership of a project from your Personal or Organization account (source) to another person or company (destination), and you are not allowed "Owner" or "Admin" permissions on the destination account, you can create an escrow account (a new Organization account). This solves the problem that a user must be an "Owner" on the source account and either an "Owner" or "Admin" on the destination account to transfer projects between them. Once the escrow account is created, you can grant the ultimate destination account member the Owner role on the escrow account and safely transfer the project to the escrow account. The receiving person or company can then transfer it to their destination account from the escrow account without having had access to the destination account itself.

Manage access

Access for members is managed through a role-based system. Users can have the owner, admin, developer, or viewer roles within an Organization account.

RoleDescription
OwnerCan take any action on an account or any projects, including deleting them.
AdminCan control most settings on your account, including signing up for paid services, changing permissions of other users, and managing programmatic access.
DeveloperCan create new projects, make new builds, release updates, and manage credentials.
ViewerCan only view your projects through Expo Go but cannot modify your projects in any way.