What Are Dynamic Fields?
Dynamic Fields let you display information that's unique to each individual passholder directly on their pass. Instead of every pass showing the same static text, Dynamic Fields pull in values specific to that user, such as their name, membership ID, points balance, reward value, affiliate link, or event ticket number.
Common examples include:
Member name or ID number
Loyalty points or reward balance
Unique QR or barcode for event access
A personalized affiliate or referral link
Expiration dates tied to individual accounts
Finding the Dynamic Fields button
Open the Pass Editor for your pass template.
On any field (front or back of the pass), look for the lightning bolt ⚡ icon on the right side of the field.
Click the icon to open the Dynamic Fields dropdown. Email is available by default for all passes.
Select the Dynamic Field you want to apply to that field.
Once at least one Dynamic Field is applied, the ⚡ tab in the Pass Preview Toolbar will highlight in yellow, confirming it's active.
Adding Custom Attributes
If the default fields don't cover what you need, you can create your own Custom Attributes to display any user-specific or pass-specific data you'd like.
There are two types of Custom Attributes:
Type | What It Does |
User Attributes | Shared across all passes assigned to a user (e.g., member name, points balance, tier) |
Pass Attributes | Unique to a specific pass (e.g., ticket number, event date, order ID) |
Custom Attributes can be added two ways:
In the Pass Editor: Click "+ Custom Attribute" in the Dynamic Fields dropdown to define a new attribute directly in the UI.
Via the Badge API: Use the
userPassUpsertendpoint to set or update attribute values programmatically at issuance or any time after.
✏️ Naming tip: For pass-specific attributes, use a prefix tied to the pass name to avoid conflicts across templates. For example, theBigShow_orderNumber rather than just orderNumber.
📄 For full details on setting Custom Attributes, including how to populate them at scale via CSV or API, see How to Set Custom Attributes →
Testing Dynamic Fields
Click the yellow ⚡ tab in the Pass Preview Toolbar to enter preview mode. From here, you can enter test data to simulate how the pass will appear with real user values populated.
💡 Dynamic Fields in the preview are underlined to distinguish them from static text. When you're done previewing, switch back to the Apple or Google Wallet tab in the toolbar to return to the standard pass preview.
We also recommend installing a real test pass on your own phone by using your pass invite link (found on the Passes page). Seeing it live on a device is the best way to validate how Dynamic Fields look and behave for your users.
🔑 Key Things to Know
Dynamic Fields can be applied to any field on both the front and back of a pass, including links.
A Custom Attribute added to one field is available to use on other fields on the same pass as well.
User Attributes are shared across passes for the same user, so updating a member's name or balance in one place reflects across all their passes.
Pass Attributes are pass-specific, making them ideal for unique identifiers like ticket numbers or order IDs.