An Organization is the top-most container in a Builder account and serves as a central place to manage users, billing, and Spaces.
When you sign into Builder for the very first time, Builder creates an Organization for you. Within that Organization, Builder also creates one Space with the same name as the Organization. Typically, a company only has one Organization, which contains the company's Space(s).
The diagram below shows the relationship between an Organization and its Spaces:
An Organization gives you a way to manage the following:
- Users at the Organization level: all users must exist in the Organization before you add them to a Space.
- Spaces
- Organization Usage Insights
- Organization Private API Key
- Subscription and Billing
All of your Spaces reside within your Organization. It is inside each Space that you:
- Manage users specific to that Space
- Create models and content entries
- Access content insights
- Set up targeting
- Manage A/B Testing
- Use integrations and plugins
- Access your Space Public and Private API Keys
- Set up Environments (for Enterprise plans)
Most of the time, you'll work in a Space, but you'll switch to the Organization view when you need to do things specific to the Organization such as manage billing or add users.
To view your Organization info:
- Hover over the Builder logo in the upper left of the Builder UI.
- Click the down arrow to see your Organization and Space options.
- Hover over the Organization and in the menu that opens, click on the Go button for the Organization.
The following video demonstrates opening an Organization called Basic Docs Demos, viewing the Spaces within the Organization, as well as viewing the Organization's Settings:
For more in-depth information, refer to Managing Your Organization.
If you're using Shopify with Builder, the structure is a little different. For Shopify stores, your Organization and Space are rolled into one entity, the Organization. Within your Organization is your content, where you manage everything.If you happen to have two Shopify stores, then you have two Organizations, rather than two Spaces.
To learn what you can do at the Organization, read Managing Your Organization, which goes through each of the options available for Organizations.
Looking to hire a third party to help with your project?
Submit a project request and our partnerships team will reach out to connect you with an Expert from our partner ecosystem.
