The Data Field Manager allows you to update field properties and view your fields and usage in one place. You can also use the Data Field Manager to permanently delete fields from the template record, which helps avoid confusion between unused fields on the design.
Terminology
Template Record
The master structure containing the fields and settings for a pass design.
Pass Designer
The interface used to visually create and modify the appearance of a digital pass.
Field Key
The unique identifier assigned to a data field, often used for API interactions.
API (Application Programming Interface)
A set of rules and specifications that software applications can follow to communicate with each other.
JSON (JavaScript Object Notation)
A lightweight data-interchange format used for representing structured data.
Template Override
Customisations applied to a specific platform's (e.g., Google Wallet) display of a field.
Lock Screen Message
A notification displayed on a device's lock screen when a field is updated.
Relative Date
A date displayed in relation to the current time (e.g., "in 2 days").
Absolute Date
A date displayed with a specific date and time (e.g., "December 25, 2024").
Link Suppression
The ability to prevent automatic link generation for text fields.
Opening the Data Field Manager
The data Field Manager can be access from the left hand menu when viewing the designer.
Navigate to the the Data Field Manager
When viewing the pass designer, click on the Data Field Manager icon.
Data Field Manager Columns
1. Data Fields
This displays the field key. This is useful to identify fields where the label may not be descriptive, and for use with the API.
2. Usage
This displays where the field is currently being used.
Apple Wallet
Google Wallet
Data Collection Form
3. Field Type
Protocol Field - These are fields specific to the pass type you have selected.
PII Field - This field is for PII data (Personally Identifiable Information), which is any data that can be used to identify a specific individual. These fields are encrypted on our servers.
Static Field - These fields are custom fields, which can hold data that is the same for all passes.
Meta Field - These field contain data which can be different for each individual pass.
Universal Field - A predefined field that can hold a static data.
4. Label
This displays the label of the field.
Managing Fields in the Data Field Manger
The Data Field Editor
Clicking on the Field row will open the editor
The editor has 4 tabs.
Details
Here you can edit the,
Label - This is the field label displayed on the pass design
Link Generator - Used to create pretty links to use in Apple Wallet text fields
Default Value - The default value (mainly used for static fields)
Delete Field - This permanently deletes the field from the template
Note: Any greyed out fields cannot be edited
Apple Wallet
Here you can edit specific Apple Wallet settings for the field.
Is Relative Date - This value determines whether a date is displayed as a relative date (e.g., "in 5 minutes," "yesterday") or as an absolute date (e.g., "October 26, 2023").
Change Message - This is the message that is shown on the device lock screen when a field is updated.
Data Field - This applies to Date/Time fields and will determine the style in which the date is shown
Link Suppression - This allows you to disable Apple Wallet automatically creating links from properly formatted text, like addresses, dates, URL's (which haven't used <a> tags and phone numbers.
Google Wallet
This will show how the field is displayed in the Google Wallet template override section. Useful for developers and diagnosing template issues.
Apple Wallet
This shows the specific field JSON that is used in the template. Useful for developers and diagnosing template issues.
Editing a field in the Field Manager
Click on the Field row to open the editor
Make any changes, then click Done when finished. Click save to save all changes.
Deleting a Field
This action will permanently delete the field from the pass, and the template.
To remove a field from either the Apple design, Google design or Data Collection form design only, this should be done from the pass designer.
Click on the Field row to open the editor, then click on DELETE to delete the field and confirm you wish to delete the field.