Skip to page contentSkip to chat
ServiceNow support
    • Community
      Ask questions, give advice, and connect with fellow ServiceNow professionals.
      Developer
      Build, test, and deploy applications
      Documentation
      Find detailed information about ServiceNow products, apps, features, and releases.
      Impact
      Accelerate ROI and amplify your expertise.
      Learning
      Build skills with instructor-led and online training.
      Partner
      Grow your business with promotions, news, and marketing tools
      ServiceNow
      Learn about ServiceNow products & solutions.
      Store
      Download certified apps and integrations that complement ServiceNow.
      Support
      Manage your instances, access self-help, and get technical support.
How to add query criteria to an snRecordPicker element in Service Portal - Support and Troubleshooting
  • >
  • Knowledge Base
  • >
  • Support and Troubleshooting (Knowledge Base)
  • >
  • How to add query criteria to an snRecordPicker element in Service Portal
KB0724551

How to add query criteria to an snRecordPicker element in Service Portal


8512 Views Last updated : Jun 18, 2025 public Copy Permalink English (Original)
  • English (Original)
  • Japanese
KB Summary by Now Assist

Issue

Service Portal widgets can use snRecordPicker and snReferencePicker directives to render a dropdown list with autocomplete functionality. Administrators may want to add criteria to GlideRecord queries performed by these tools in order to search for a more specific set of records.

Release

 London  

Resolution

Following is an example of the HTML template of a properly defined snRecordPicker when used in a widget to search for records from the sys_user table against the name field.

HTML Template
<sn-record-picker
  field="name"
  table="'sys_user'"
  display-field="'name'"
  value-field="'id'"
  display-fields="'name'"
  search-fields="'name,email'"
  page-size="100"
  placeholder="Search for a user."
  default-query="'nameLIKEAdmin'" />
 

Note: The information in this article is based on undocumented code as of London. As such, it is subject to change and may not reflect functionality in other versions. When upgrading, make sure to review the behavior of any customizations made to widgets to ensure desired behavior is consistent from version to version.

Related Links

For instructions on how to use snReferencePicker, see How to add query criteria to an snReferencePicker element in Service Portal

 


The world works with ServiceNow.

Sign in for more! There's more content available only to authenticated users Sign in for more!
Did this KB article help you?
Did this KB article help you?

How would you rate your Now Support digital experience?

*

Very unsatisfied

Unsatisfied

Neutral

Satisfied

Very satisfied

Very unsatisfied

Unsatisfied

Neutral

Satisfied

Very satisfied

What can we improve? Please select all that apply.

What are we doing well? Please select all that apply.

Tell us more

*

Do you expect a response from this feedback?

  • Terms and conditions
  • Privacy statement
  • GDPR
  • Cookie policy
  • © 2025 ServiceNow. All rights reserved.