Free5 minutesbeginner

Role-Based Access Control

Understand Zenovay roles and permissions - control who can view, edit, and manage your analytics data.

rolespermissionsaccesssecurityrbac
Last updated: January 15, 2025

Role-based access control (RBAC) lets you assign permissions to team members based on their responsibilities. Each role has specific capabilities.

Available Roles

Role Overview

RoleDescription
OwnerComplete control, billing access
AdminFull access except ownership transfer
EditorManage websites and data
ViewerRead-only access

Role Hierarchy

Owner (highest)
  └── Admin
        └── Editor
              └── Viewer (lowest)

Higher roles include all permissions of lower roles.

Permission Matrix

Core Permissions

PermissionOwnerAdminEditorViewer
View analytics
Export data
Create goals
Manage websites
Invite members
Remove members
Manage billing
Transfer ownership
Delete team

Analytics Permissions

PermissionOwnerAdminEditorViewer
View dashboard
View real-time
View sessions
View heatmaps
Download reports
Create filters
Save views

Configuration Permissions

PermissionOwnerAdminEditorViewer
Add websites
Edit website settings
Delete websites
Create goals
Delete goals
Manage integrations
API key management

Role Details

Owner

The team owner has complete control:

Can do everything including:

  • Access and manage billing
  • Transfer ownership to another admin
  • Delete the entire team
  • All admin, editor, viewer permissions

Limitations:

  • Only one owner per team
  • Cannot remove themselves
  • Must transfer before leaving

Admin

Admins have full operational access:

Can:

  • Manage all team members
  • Configure all settings
  • Access all features
  • Create/delete websites
  • Manage integrations

Cannot:

  • Access billing
  • Transfer ownership
  • Delete the team

Editor

Editors can modify data and settings:

Can:

  • View all analytics
  • Add and configure websites
  • Create and manage goals
  • Set up funnels
  • Configure tracking

Cannot:

  • Invite or remove members
  • Delete websites
  • Manage integrations
  • Access team settings

Viewer

Viewers have read-only access:

Can:

  • View all analytics data
  • Access dashboards
  • Export reports
  • Watch session replays
  • View heatmaps

Cannot:

  • Make any changes
  • Create goals or funnels
  • Add websites
  • Modify any settings

Assigning Roles

When Inviting

Select role during invitation:

  1. Click "Invite Member"
  2. Enter email
  3. Choose role from dropdown
  4. Send invitation

Changing Roles

To change an existing member's role:

  1. Go to Settings → Team
  2. Find the member
  3. Click "Edit"
  4. Select new role
  5. Save changes

Changes take effect immediately.

Custom Roles

Enterprise Plan

Enterprise plans can create custom roles:

Creating Custom Roles

  1. Go to SettingsTeam tab
  2. Click "Create Role"
  3. Name the role
  4. Select permissions
  5. Save

Example Custom Roles

Custom RoleUse CasePermissions
AnalystData teamView all + export
ManagerDepartment headsView + create goals
DeveloperTechnical teamView + API access
AuditorComplianceView + audit logs

Assigning Custom Roles

Use like built-in roles:

  1. Invite or edit member
  2. Select custom role
  3. Permissions apply

Website-Level Access

Scale Plan

Restrict access to specific websites:

How It Works

Team: Acme Inc

Websites:
├── marketing.acme.com (All members)
├── sales.acme.com (Sales team only)
└── internal.acme.com (Admins only)

Setting Up

  1. Go to Settings → Team → Members
  2. Click member name
  3. Select "Website Access"
  4. Choose allowed websites
  5. Save

Use Cases

ScenarioConfiguration
Department separationEach team sees own sites
Client privacyStaff only see assigned clients
Sensitive dataRestrict to admins

Best Practices

Principle of Least Privilege

Assign minimum necessary access:

  • Start with Viewer
  • Upgrade as needed
  • Review periodically

Role Assignment Guidelines

Team MemberRecommended Role
CEO/ExecutiveViewer or Admin
Marketing ManagerEditor
Data AnalystViewer
IT AdministratorAdmin
External PartnerViewer (restricted)
DeveloperEditor or Admin

Regular Audits

Review access periodically:

  • Check member roles quarterly
  • Remove unused accounts
  • Verify role appropriateness

Troubleshooting

Can't Access Feature

If a member can't access something:

  1. Check their current role
  2. Verify permission requirements
  3. Upgrade role if appropriate

Can't Change Roles

If you can't modify roles:

  • Verify you're Admin or Owner
  • Check if targeting the Owner
  • Ensure member exists

Need Custom Permissions

If built-in roles don't fit:

  • Upgrade to Enterprise for custom roles
  • Use website-level restrictions
  • Contact support for options

Security Considerations

Before Assigning Admin

Consider:

  • Business need for access
  • Trust level
  • Training completed
  • Responsibilities

Removing Access

When someone leaves:

  1. Remove immediately
  2. Don't just downgrade
  3. Review their past actions
  4. Update shared credentials

Audit Trail

All role changes are logged:

  • Who made the change
  • What changed
  • When it happened

Next Steps

Was this article helpful?