Skip to main content
Using the Data Field Manager

Edit, Manage and permanently delete fields in one place

Danny Allen avatar
Written by Danny Allen
Updated over 2 weeks ago

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.


Did this answer your question?