👥 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.
