Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Display values

Reference fields store a sys_id for each referenced record in the database, but the sys_id is not shown.

The reference field shows the display value. For example, an incident's Assigned to field stores the sys_id of a particular user, but actually displays the user's name. The following example shows how Charlie Witherspoon, which is the display value of a user record, is shown in the Assigned to field.

Image omitted: DisplayValueXml.png
XML demonstrating an assigned\_to element with a sys\_id as the value and an assigned\_to="Charlie WItherspoon" attribute.Charlie Witherspoon is displayed in the Assigned to form field instead of the sys\_id.
Reference fieldValue stored in databaseDisplay value field of source tableValue displayed in UI
Assigned to [task.assigned_to]46b87022a9fe198101a78787e40d7547Name [sys_user.name]Charlie Whitherspoon

Reference fields show display values in:

Related topics

Unique record identifier (sys_id)