Where an Organization is like a building, a Space is like a room within that building. Cross-functional teams do most of their work in a specific Space. When setting up and managing users, an Admin determines who can access which Spaces.
Use a Space as a dedicated place to work with complete separation of content. Generally, one Space integrates with one app or codebase.
Examples include:
- Spaces for separate projects or sites: for example, one Space for an e-commerce store and another for a marketing site
- Spaces for separate brands: for example, managing multiple brands with separate sites and teams
- Spaces for separate business units: for example, separate sites and teams per locale
Multiple spaces are ideal when there is no content overlap. If you do have content and user overlap, consider instead, one Space in which you tailor user experience with targeting and custom fields.
All Spaces are within Organizations. Organizations and Spaces are available through the flyout menu at the upper left of the Builder UI. The following video shows accessing two different Spaces that reside within the same Organization.
If the Space you need isn't in the list but does exist in that Organization, contact your team's Admin to make sure they've added you to the Organization and Space.
If you're using the Builder Shopify app, each store is a separate Space. When you install the app on your store, a Builder Space is automatically created.
One Space is usually integrated with one codebase or app. With an integrated app, your developer can integrate Pages, Sections, and Data.
This means that a developer can work on the code while non-developer teammates create and iterate on content entries. The developer can create drag-and-drop components that render in the Visual Editor in the integrated Space.
In this way, an integrated Space is a visual place for all members of your team to collaborate on an app.
A Space is where you complete everyday tasks such as:
- 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
- Access your environments (Enterprise plans)
Contributors, Editors, Designers, Developers, and Admins collaborate in a dedicated Space.
When setting up and managing users, an Admin determines who can access which Space(s). All users must exist in the parent Organization as well as in the Space they need to work in.
If you're on an Enterprise plan, you can use custom roles to limit what users can see even if the content is all within a single Space. Additionally, you can specify permissions by environment. For more detail, see Environments and Permissions.
For more information, see the following documents:
With an Enterprise plan, you can create environments for a Space. Environments help you develop content and models and push to production when you're ready. You can also granularly leverage Live Sync, which automatically updates content and models.
For more information Setting Up Environments.
This document covered the underlying concepts of Spaces. To learn how to accomplish Space-specific tasks, see Managing Spaces.
