enterprise add-on
Use custom roles to create customized user permissions and workflows.
If you'd like to add this feature on to your Enterprise plan, contact your Account Executive, email sales@builder.io, or reach out to us through our contact form.
To define custom roles, make sure:
- You're familiar with Builder's standard roles and permissions.
- You have this feature as an add-on.
You can define new custom roles that have any—or all—of the below permissions and access:
| Permission | Description |
|---|---|
Publish/Unpublish content | User can can publish or unpublish content entries. |
Edit designs | User can edit styles from the Style tab. |
Admin | User can manage all users and billing. |
Edit code | User can add and edit code within Builder, such as custom HTML, CSS, JS. |
Edit layouts | User can add, remove, and rearrange blocks in the Visual Editor. When this setting is off, users can only edit options such as text and images. |
Create content | User can add new content entries. |
Access | User can access all models or models the Admin selects. |
Locale access | User can access all locales or locales the Admin selects. |
You can adjust permissions at the Space level or on a per-content model basis. This means you can allow custom roles to only have access to certain models and, within each model, you can apply filters to make the control even more granular based on the fields, data, and targeting properties associated with the model.
For example, if you want to use the same model across multiple projects—such as domains, locales, or environments—within the same space, but only allow certain users to access/view specific projects using that model, then you can create a custom role for that purpose using model-specific permissions and filters.
The sections that follow demonstrate the process for specifying basic permissions as well as permissions based on models along with using filters.
- Go to Account Settings.
- Click the Pencil icon to the right of Roles.
- Click + New Role.
- Give the new role a Name and Description.
- Choose the Permissions you'd like. See the previous table describing each.
- Click Save.
When choosing permissions as above, you can specify particular models.
- Follow steps 1-5 above.
- Select All Models if you'd like this role's permissions to apply to all models.
- Deselect All Models to display a list of all of the available models and choose the models to which you'd like to apply the permissions.
- To further refine permissions when selecting individual models, expand that model and click + Filter.
- Select the model's property to add permissions for that property.
- Click Save.
The following video demonstrates these steps.
Note that you can select any of the locales that you have configured. Additionally, you can select the Default locale; that is, whichever locale you've specified as your default locale.
When you assign custom roles to users (or use the built-in roles), as an Admin, you can confirm that the role you've assigned provides the intended access to your users. For details on using the role switcher to experience Builder as a given role, visit Verifying role access with the role switcher in Managing Users.
