Define the reference key
task australia Updated Sep 10, 2026 1 min read t_DefineTheReferenceKey.md
By default, reference fields store the sys_id of the record in the database.
Before you begin
Role required: personalize_dictionary
About this task
By defining a reference key, you can identify a field other than sys_id to use as the unique identifier for the reference field. The value of the reference key field, instead of the sys_id, is stored in the database for that reference field.
Procedure
-
Navigate to All > System Definition > Dictionary.
-
Open the field record (for example, resolved_by on the Incident table).
-
In the Reference key field, enter a field name on the referenced table (for example, email on the sys_user table).
Note: Always choose a field from the referenced table that is both required and unique.
-
Select Update.
38 lines · 1.3 KB
---
title: Define the reference key
description: By default, reference fields store the sys\_id of the record in the database.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/platform-administration/t\_DefineTheReferenceKey.html
release: australia
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Add a reference field, Reference field type, Reference, Field administration, Forms, fields, and lists, Configure core features, Administer the ServiceNow AI Platform]
---
# Define the reference key
By default, reference fields store the sys\_id of the record in the database.
## Before you begin
Role required: personalize\_dictionary
## About this task
By defining a reference key, you can identify a field other than sys\_id to use as the unique identifier for the reference field. The value of the reference key field, instead of the sys\_id, is stored in the database for that reference field.
## Procedure
1. Navigate to **All** > **System Definition** > **Dictionary**.
2. Open the field record \(for example, **resolved\_by** on the Incident table\).
3. In the **Reference key** field, enter a field name on the referenced table \(for example, email on the sys\_user table\).
**Note:** Always choose a field from the referenced table that is both required and unique.
4. Select **Update**.
| title | Define the reference key |
| description | By default, reference fields store the sys\_id of the record in the database. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/platform-administration/t\_DefineTheReferenceKey.html |
| release | australia |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Add a reference fieldReference field typeReferenceField administrationFormsfieldsand listsConfigure core featuresAdminister the ServiceNow AI Platform |