Skip to main content

🔐 Retailer App – Permissions & User Access

👥 1. Understanding Roles and Permissions

In the Retailer App, access to features and data is controlled using roles and permissions.

Permissions determine:

  • What actions a user can perform

  • Which areas of the platform they can access

  • Which locations they can view

Each user is assigned a role, and each role includes a set of permissions.

Roles themselves are managed by Instore.AI, while customers can assign roles to users within their organization.

This approach ensures consistent access control across all accounts while keeping the system secure and easy to manage.


🧩 2. How Roles Work

Every user in the Retailer App must have a role.

A role defines the set of permissions available to that user.

When a role is assigned to a user, it determines:

  • Which features appear in the application

  • Which actions the user can perform

  • Which data the user can access

The application automatically adapts based on the user's role. Users will only see features that they are allowed to use.

This helps keep the interface simple and ensures users only interact with relevant parts of the platform.


🧩 3. Types of Permissions

Permissions in the Retailer App are grouped by functional areas.
Each permission controls access to specific parts of the platform.


📊 Analytics Permissions

These permissions control access to analytics and interaction insights.

Permission

Description

View Event Dashboard

Allows users to access the Event Dashboard and review interaction insights and performance trends.

View Timeline

Allows users to view interactions in the Timeline and analyze activity over time.

View Search & Scheduled Reports

Allows users to search interactions and access scheduled search reports.


👤 Profile Permissions

These permissions control access to alerts and weekly performance summaries within the My Profile area.

Permission

Description

Manage Alerts

Allows users to view and manage alerts in their profile settings.

Manage Pulse Reports

Allows users to access Pulse Reports in their profile settings.

Currently, these permissions determine whether users can view and manage alerts or Pulse Reports in their profile settings.

In a future update, these permissions may also determine whether a user can receive alerts or Pulse Reports automatically.


🎧 Audio Permissions

Audio permissions control how users interact with recorded interactions.

Permission

Description

Listen to Audio + Share

Allows users to play audio recordings and share them within the platform.

Download Audio

Allows users to download recordings to their device.

The Download Audio permission requires the Listen to Audio + Share permission.


🖥️ Device Portal Permission

Permission

Description

View Device Portal

Allows users to access the Device Portal to view device status and information. Access is read-only.

Users will only see devices connected to their assigned locations.


👥 User Management Permissions

These permissions allow administrators to manage users within their organization.

Permission

Description

Manage Users

Allows users to view, create, and edit users.

Delete Users

Allows users to remove users from the system.

For security reasons:

  • Users cannot modify their own permissions

  • Users cannot change their own assigned locations


📍 4. Location-Based Access

User access is also limited by assigned locations.

This means users can only view data and activity from the locations assigned to them.

Location access affects:

  • Analytics dashboards

  • Interaction search

  • Timeline views

  • Audio playback

  • Alerts and reports

  • Device portal visibility

Even if a user has permission to access a feature, they will only see data from their assigned locations.


🔄 5. When Permissions Change

If a user's role or assigned locations change, the update may require the application to refresh so the new permissions can take effect.

In a future update, users may see a notification asking them to refresh their browser to apply updated access settings.

This ensures users always see the correct features and data based on their most recent permissions.

Did this answer your question?