Page Reference Utils
lightning:pageReferenceUtils
Provides utilities for encoding and decoding default field values. This component requires API version 48.0 or later.
For Aura components only. For LWC development, use lightning/pageReferenceUtils.
For Use In
Lightning Experience
The lightning:pageReferenceUtils component provides utilities for encoding and decoding default field values. Pass this string into the pageReference.state.defaultFieldValues attribute on standard__objectPage page reference types.
Encodes default field values from a JavaScript object into a serialized string.
| Property | Type | Description |
|---|---|---|
| defaultFieldValues | object | List of default key-value pairs for the default field values you are passing. |
Decodes default field values from a serialized string into a standard object. Use this method when overriding a standard action only.
| Property | Type | Description |
|---|---|---|
| encodedDefaultFieldValuesString | string | Encoded string of default field values. The values returned by this method are strings. Field type isn't preserved. |
The key-value pairs of an object are encoded into a serialized string that you pass into the pageReference.state.defaultFieldValues property.
These objects are not supported by lightning:pageReferenceUtils:
- ContractLineItem
- OpportunityLineItem
- OrderItem
- QuoteLineItem
- WorkOrderLineItem
Passing the recordTypeId to defaultFieldValues is not yet supported. The recordTypeId influences routing behavior, layout assignment, and page assignment, so you can see unexpected results if you try to use it.
You can specify values for fields even if they’re not available in the create record form.
- If the field is hidden because it’s not on the page layout, the value specified in
defaultFieldValuesis saved with the new record. - If the current user doesn’t have create access to the field, due to field-level security, attempts to save the new record result in an error.
Error messages can’t reference fields that the current user doesn’t have access to. This constraint means the user won’t know why the error occurred or how to resolve the issue. It’s essential to perform access checks in your own code before firing the event.
You can’t prepopulate system-maintained fields, such as Id or record modification time stamps. Default values for these fields are silently ignored.
Prepopulating rich text fields is unsupported.
Date and time field values must use the ISO 8601 format. For example:
- Date: 2017-07-18
- Datetime: 2017-07-18T03:00:00Z
While the create record page presents datetime values in the user’s local time, you must convert datetime values to UTC to prepopulate the field.