Samaksh Wani
Giga Sage
Giga Sage

Hi Community,

While working on a configuration in ServiceNow’s Native UI, I encountered a use case where the requirement was to display the Department field value instead of the default Email in the search suggestions of a reference field.

 

Here’s a step-by-step guide to customizing the search suggestion list for a reference field using the ref_ac_columns attribute.


Use Case:

Display the Department field value in the suggestion list of a reference field (e.g., Caller) instead of, or in addition to, the default Email value.


Configuration Steps:

  1. Navigate to the Reference Field:

    • Right-click on the reference field (e.g., Caller) in the form.

    • Select Configure Dictionary.

  2. Add the ref_ac_columns Attribute:

    • In the Attributes field, add the following:

      in attribute Field.
       
      ref_ac_columns=department
      SamakshWani_0-1750940418731.png

       

    • This will ensure that the Department field value appears in the suggestion list when searching in the reference field.

SamakshWani_1-1750939904652.png

 


To Display Multiple Fields (e.g., Email and Department):

If you want to show both the Email and Department values in the search suggestion list, use a semicolon-separated format:

 

in attribute Field.
 

ref_ac_columns=email;department

 

💡 Note:

  • Attribute values should be separated by commas when combining multiple attributes.

  • Field values within the ref_ac_columns attribute should be separated by semicolon(;).

 

SamakshWani_2-1750940059648.png

 

 

If you found this article helpful, please consider giving it a thumbs up!

 

Best regards,
Samaksh Wani
Rising Star 2023 & 2024

Comments
MK4
Tera Contributor

Very Helpful! Thank you

GOKUL PRASATH N
Tera Explorer

Informative..

Version history
Last update:
‎06-26-2025 05:20 AM
Updated by:
Contributors