Why user management matters
Section titled “Why user management matters”Controlling who can create, edit, approve, and publish content is essential for governance. Too few permissions and your team is bottlenecked on a single admin. Too many and you risk unauthorized content going live. This guide covers both identity management (who can log in) and content permissions (what they can do once logged in).
Invite users via Opti ID
Section titled “Invite users via Opti ID”Opti ID is the identity layer for all Optimizely products. Users are managed at the organization level.
- Log into the Optimizely portal
- Navigate to Organization → Users
- Click “Invite User”
- Enter the user’s email address
- Assign product roles (CMS Editor, CMS Admin, etc.)
- Click “Send Invite”
The user receives an email invitation and creates their Opti ID account.
CMS roles reference
Section titled “CMS roles reference”| Role | What they can do |
|---|---|
| CMS Admin | Full access: manage content types, settings, scheduled jobs, users |
| CMS Editor | Create, edit, and publish content within permitted areas |
| CMS Approver | Review and approve content in workflows |
| CMS Reader | View content in the editor but cannot make changes |
| Web Admin | Manage site settings, visitor groups, and configuration |
Set content-level permissions
Section titled “Set content-level permissions”Beyond roles, you can set permissions at any level of the content tree. Permissions are inherited downward — setting permissions on a folder applies to all pages within it.
- In the CMS editor, navigate to the content item or folder
- Open “Set Access Rights” (right-click → Access Rights, or via the properties panel)
- Add users or groups
- Set permission levels:
- Read — Can view the content in the editor
- Create — Can create child pages or blocks
- Edit — Can modify content
- Delete — Can remove content
- Publish — Can publish content live
- Administer — Can change permissions on this content
Best practice: Set permissions on folders, not individual pages. Create a content tree structure that mirrors your organizational permissions.
Configure approval workflows
Section titled “Configure approval workflows”Workflows ensure content is reviewed before publishing. To set up a basic approval workflow:
- Navigate to CMS Admin → Content Approval
- Select the content area where approval is required
- Define approval steps — each step has one or more reviewers
- Set the scope — which content tree branches require approval
- Save the workflow
When an author submits content for review:
- The assigned reviewer receives a notification
- They can approve, request changes, or reject
- Approved content moves to the next step (or publishes if final step)
Enterprise SSO integration
Section titled “Enterprise SSO integration”For organizations using an identity provider (Okta, Azure AD, Google Workspace):
- In the Optimizely portal, navigate to Organization → SSO Settings
- Configure SAML 2.0 or OpenID Connect with your identity provider
- Enable SCIM provisioning for automatic user sync
- Set MFA policies (required for all users, or specific roles)
With SSO configured, users log in with their corporate credentials. No separate Optimizely password is needed.
Common tasks
Section titled “Common tasks”| Task | Where to do it |
|---|---|
| Add a new user | Opti ID portal → Users → Invite |
| Change a user’s role | Opti ID portal → Users → Edit roles |
| Remove access | Opti ID portal → Users → Deactivate |
| Set content permissions | CMS editor → Right-click → Access Rights |
| Configure approval workflow | CMS Admin → Content Approval |
| Set up SSO | Opti ID portal → Organization → SSO Settings |