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=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy8yMzgxLzQ0MDcvY2tmaW5kZXIvaW1hZ2VzL3F1LzIwMjUvaW1hZ2UoMSkucG5nIiwiQ29uZGl0aW9uIjp7IkRhdGVMZXNzVGhhbiI6eyJBV1M6RXBvY2hUaW1lIjoxNzg2MzkwNjIyfX19XX0_&Signature=SjCIlUxkhGILW2wvo8UHydm8U4IziD87bQWRIUdRRwRkGmC7eTncXN7Bwl6KScCD2c-6ggEdxw04UkCBl1UfyWRNF48Y95Hy1nlwIME5bqikCLCZJknTEXrdhhC6HIZ3BGowUf-lmLiIZZrF1e1Ui-BNEai7b0cXQD732~Zg~R4I1NGoV5XvaqXXbPDMFQG9yII2W0o4-1C510kcrDzWs3RuJCIBJ1qM4wvGIQbHruiRLdm7CdevRELbhTjuJukletkE7N1z6n5UvSVb1cmvFujHyFb3vhznlr6cypdlHSHmnUw4opFcxni0ikkV3FqILrNzO8VmhCN8d6susOz38A__&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=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy8yMzgxLzQ0MDcvY2tmaW5kZXIvaW1hZ2VzL3F1LzIwMjUvaW1hZ2UoMikucG5nIiwiQ29uZGl0aW9uIjp7IkRhdGVMZXNzVGhhbiI6eyJBV1M6RXBvY2hUaW1lIjoxNzg2MzkwNjIyfX19XX0_&Signature=re1fwB2Sb~2gFg0Re96SLofDFH-9naCcE-tI7cssIWS3Cb~Lo78OLkBKX9SlQorip8JVjjg4yhcwdmsAetVCOmPEMz9X80vgWohdKSt1CQ44MYTPb~IS~QdD7Isuu5jYIREFYqjUsOegQSLkVq-R4PChdhRpDDe47j2F9C4PsLdhXGVRWsnrX~vA8EvFc7kMW62g4yUrHu5HC~bkor3wr7orpQ52URO5BoIJIYurAiByYv4GRpF2AZra2w1aivPGwZ3BpppnF9Qb-s-T-DZ82zpY1ps~0D5h8YaaZRtwbfiXk31aYvN0HPqh4T0l7iCpTSUAwVx0lM8O0SjvTHUr~g__&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.