An Expo account is a container that holds Expo projects and allows for different amounts of collaboration. There are three types of Expo accounts; Personal, Organization, and Team. What type of account you choose to put a new project in depends on the nature of the project and, if you plan to collaborate with others, with whom you plan to collaborate.
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.
You must not share authentication credentials for your Personal Account with anyone for any reason.
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, then give these members different roles that grant a level of access within the organization. For more information, see role privileges.
It may be useful to create an Organization when:
If you are logged in to your Personal Account, you can create a new Organization from the dashboard:
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.
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:
The Organization Account will adopt your old username. Converting a Personal Account into an Organization Account requires that you 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 "kamalaya8":
After completing the conversion process, you will no longer be able to 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 top left dropdown to access the organization.
Other Expo users can be invited to join your Organization. To invite a new member:
When inviting a new member, keep in mind:
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.
After renaming an account, new publishes to projects within the account must be on Expo SDK 43 or above.
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.
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 cannot be given "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.
For all new accounts where you want to share access, we recommend you to create a new Organization Account. It allows more flexibility in role assignments. Creating a Team Account is deprecated.
To create a Team Account, simply invite Team members to a Personal Account.