Q-assign User Record Viewer – Setup & Usage Guide
The Q-assign User Record Viewer widget allows users to view real-time records being assigned via Q-assign. This widget is especially useful for monitoring individual workload and assignment flow directly within your Salesforce app.

How to Set It Up
To add the Q-assign User Record Viewer widget to your app:
-
Navigate to Setup in Salesforce.
-
Go to App Manager.
-
Locate and click Edit next to the desired app.
-
Scroll to Utility Items (under App Settings).
-
Click Add Utility Item.
-
Search for Q-assign User Record Viewer and add it.
-
Set the utility item properties as desired.
-
In the configuration panel, you’ll see a few fields you need to complete:
Component Properties:
-
SObject API Name:
Enter the API name of the object you want to monitor (e.g.,Case,Lead,Custom_Object__c). -
Field to Display:
Enter the API name of the field you want shown in the viewer (e.g.,Subject,Name,CaseNumber). -
Records Filter (optional):
Add a single filter condition to narrow down which records are displayed.
Example:Subject = 'Test'
-
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy8yMzgxLzQ0MDcvY2tmaW5kZXIvaW1hZ2VzL3F1LzIwMjUvaW1hZ2UoMSkucG5nIiwiQ29uZGl0aW9uIjp7IkRhdGVMZXNzVGhhbiI6eyJBV1M6RXBvY2hUaW1lIjoxNzc2Njg3NjEwfX19XX0_&Signature=O-YLdEBYd4h311-p25HGPOOqa6fkNyoMwlaspHCRmB5iz~vQgFDcXuJ9~V~-ugGt-MOoL4qIFW8bwc3D6GiYMwJUZRaklKh3jexCJPA2DjV8sWNZxakRHnbkJueQGQc22Jzgi~Ifgdz3t0es5fclBE5J268G-BL5rfJodKcRoL9KhCREcVEPnZQ8SlrFbNqCxM5T109wHXjXUawlr5PrOFt8IhClNORsT6bcIdGqzhZWuX-pDNIaJtkCmxTzlisFYrCMCjc6dG6eF66rvEYuH3vjlkJhax3glKeZUz5e5zRH8MP9rl9IvEFBBY3twfeZ5C375LGpJRRFU3KoputOfQ__&Key-Pair-Id=K2TK3EG287XSFC)
[Note: Filter Criteria Limitation: Currently, only one filter condition is supported in the viewer.
For example:
- Supported:
Subject = 'Test' - Not Supported:
Subject = 'Test' AND Company = 'Ortoo']
9. Save the changes.
Once added, the widget will appear in your utility bar and begin displaying assigned records in real time.
How to Set It Up in Q-assign Availability Component
The "Show User Records" checkbox is available in the Q-assign Availability Component. When enabled there, it similarly shows the real-time records being assigned to the logged-in user as per the individual's set-up properties.
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy8yMzgxLzQ0MDcvY2tmaW5kZXIvaW1hZ2VzL3F1LzIwMjUvaW1hZ2UoMikucG5nIiwiQ29uZGl0aW9uIjp7IkRhdGVMZXNzVGhhbiI6eyJBV1M6RXBvY2hUaW1lIjoxNzc2Njg3NjEwfX19XX0_&Signature=M7bPbs3ijxQOlJFe~b9gFZ03cu0cYWWiOzU7rxUgdxVkrJ4hryITBXk0XXxvlBCy8RDYZIwuEjwqPMMgEGBj3QoaIR2f71W9SAPeyrhZbAqjXRGMQWP2MJsf3J5jRZYgyXL-W~twon~uCDs76wihyhDmYstDDgnoDebGMQ0rQVQSpHuhhKPJ2psqe2N1bRFEdt0rqgM8RiuIpDUsO3ziL84TOMJ9okBEP5htZAJqHsecm8i~7uLFgRADHi3u8hait~xUCohLKQwZZGDx-o8Ctso0Wn2i5BbqFrjClql6ckImmZ37aD3DbFd9kTaC2KDlhQCTrXq0SOIGF5EkKDoO6A__&Key-Pair-Id=K2TK3EG287XSFC)
Please note that we have to set these properties separately. They can be different from the 'Q-assign User Record Viewer' component properties as well.
Please contact us at support@ortooapps.com for any questions.