Disclaimer: This website requires Please enable JavaScript in your browser settings for the best experience.

The availability of features may depend on your plan type. Contact your Customer Success Manager if you have any questions.

Dev guideRecipesAPI ReferenceChangelog
Dev guideAPI ReferenceRecipesChangelogUser GuideGitHubDev CommunityOptimizely AcademySubmit a ticketLog In
Dev guide

Manage audience roles

How to manage granular permissions roles for audiences in Optimizely Feature Experimentation.

You can assign the following audience roles to a collaborator or team:

  • Admin – Can view and edit the audience, and manage audience permissions for other collaborators.
  • Editor – Can view and edit the audience and its content.
  • Viewer – Can view the audience and its content.

Audience permissions

Your audience role (such as Viewer or Editor) determines your level of access to it. This role is based on where the audience is used and your permissions for those entities.

  • Unused audience – If an audience is not used in any flags, the project role determines the audience role. For example, a collaborator with the Editor project role is also an Editor for an unused audience.
  • Audiences in use – If an audience is used in a flag, your audience role is the lowest of your roles across the following:
    • The flags where the audience is used.
    • The environments within those flags where the audience is applied.

Feature Experimentation uses the least permissive role across flags and environments to ensure that collaborators cannot exceed their intended privileges. This follows the principle of least privilege. For example:

  • Consistent Editor roles – A collaborator who is an Editor for all related flags and environments is also an Editor for the audience.
  • Mixed roles – A collaborator who is an Editor for Flag A but a Viewer for the Production environment (where the audience is used) is a Viewer for the audience.

The following table summarizes permission levels:

ScenarioProject roleFlag roleEnvironment roleAudience role
Audience not usedEditorN/AN/AEditor
Audience not usedViewerN/AN/AViewer
Consistent Editor roleEditorEditorEditorEditor
Mixed roles, Viewer lowestEditorEditorViewerViewer

📘

Note

A collaborator must have Editor or Admin access in at least one environment to create an audience. For example, a collaborator with the Viewer project role can still create audiences if they are granted elevated environment-level access.

Update an audience role

  1. Go to Audiences > Saved.

  2. For the audience you want to update, select More Options (...) > Manage Permissions.

  3. Select the Users or Teams tab.

  4. (Optional) To filter collaborators or teams, you can enter a name on the Search for a user or Search for a team field.

  5. Click Edit for the user or team you want to update.

    📘

    Note

    You cannot update the audience role permissions for Administrators and Project Owners.

    All other roles display Check Details for the Audience Role because the audience role is determined based on where the audience is used and the collaborator's permissions for those entities. See the Audience permissions section for information.

  6. Select the updated Audience Role.

  7. Click Save.