Configure Google Loyalty Pass Properties

Overview

The Google tab of the Wallet Pass Details screen allows you to configure the Wallet Pass properties for Members using Google devices. As you make changes to the configuration, the platform displays a preview render of the Wallet Pass as it will appear on Google devices.

The Google tab is organized into the following sections, each of which is described below in more detail:

  • Barcode: Configure the barcode settings of the Wallet Pass.

  • Color & Images: Customize the visual elements of the Wallet Pass.

  • Front Content: Design the primary view that displays essential information to Members.

  • Details: Provide comprehensive information such as detailed terms and conditions, in addition to the Front Content.

  • Links: Provide useful links.

  • Settings: Optionally enable pass sharing.

  • Test Preview: Preview the pass functionality for Google devices using a specified Test Member.

Barcode

The Barcode section is used to configure the barcode that appears on the Mobile Wallet Pass. The preview rendering on the right updates automatically as you make configuration changes.

  1. Select the Google tab, then select the Barcode tab.

  2. Set the barcode value using one of the following methods:

    • For a fixed number (like a coupon code), type the number directly in the Barcode Value field.

    • For personalized values, enter "@" to bring up a menu of available Content Tokens; select the desired Content Token.

  1. From the Format drop-down menu, select a barcode format:

    • QR Code: Best for storing more information

    • PDF 417: Common for boarding passes

    • Aztec: Efficient space usage

    • Code 128: Ideal for numeric data

  1. Optionally, in the Alt Text field, enter alternate text using one of the following methods:

    • For a fixed value, type the value directly in the Alt Text field.

    • For personalized values, enter "@" to bring up a menu of available Content Tokens; select the desired Content Token.

  1. Click Save Changes.

Color & Images

The Color & Images section is used to customize the visual elements of the Wallet Pass.

The layout of a Loyalty Pass on a Google device is as follows:

To configure the visual elements of a Google Loyalty Pass:

  1. Select the Google tab, then select the Color & Images tab.

  2. The platform allows you to customize the Background color. Choose a color using one of the following methods:

    • Enter the desired hex code value.

    • Click the color swatch, then select the desired color from the color picker.

The platform allows you to customize the images used for the Program Logo, Hero Image, and Main Image. For each image, please note the following recommendations:

  • Program Logo: Recommended size of 660x660 pixels.This image should be your brand identifier or logo. The use of a Program Logo is optional.

  • Hero Image: Recommended size of 1032x336 pixels. This wide-format image appears at the bottom of the Loyalty Pass. The use of a Hero Image is optional.

  • Main Image: Recommended size of 1860 pixels wide, with variable height. The use of a Main Image is optional.

  1. For each option in the Images sub-section, click Choose File. Browse to and select the desired image file. The platform displays a thumbnail image. Click Upload

  2. Click Save Changes.

The preview rendering on the right updates automatically as you make configuration changes.

Note: The preview may not always render images to the correct size. Always use the Test Preview feature to see the final rendering.

Front Content

The front section of your Google Loyalty Pass serves as the primary interface for Members, displaying essential information at a glance. This section must be carefully configured to ensure optimal visibility and user experience.

The Front Content comprises three optional fields:

  • Program Name: This text appears near the top of the Loyalty Pass, and should contain your program’s official name.

  • Loyalty Points: This field can be used for elements like displaying the Member’s current Metric balance.

  • Secondary Loyalty Points: This field can be used for other elements, like the Member’s Tier status, for example.

The two Loyalty Points fields include both a Label and a Value. Typically the Label is smaller, and contains static text. The Value is larger, and will often contain a dynamic value populated by means of a Content Token. The following example shows the basic positions and appearances of the Labels and Values for each field.

To configure the Front Content:

  1. Select the Google tab, then select the Front Content tab.

  2. In the Program Name field, enter the name of your program.

  3. For the Loyalty Points field, enter the following details:

    • Label: Enter either a static value or type “@” to pull up a list of Content Tokens, and select a Content Token. This value appears in a smaller font size than the Value.

    • Value: Enter either a static value or type “@” to pull up a list of Content Tokens, and select a Content Token. This value represents the main text for this field, and is displayed in a larger font size than the Label.

  4. For the Secondary Loyalty Points field, enter the Label and Value as described above.

  5. Click Save Changes.

The preview rendering on the right updates automatically as you make configuration changes.

In the example Loyalty Pass below, the Program Name is "Kitchen Rewards." The Member’s point balance is displayed in the Loyalty Points Value by means of a Content Token called “stl_token_point.” The Loyalty Points Label contains a static value of “Point Balance.” In a similar manner, the Member’s current Tier is displayed in the Secondary Loyalty Points field.

Below is the final render of this Wallet Pass.

Details

The front of your Loyalty Pass serves as a quick-reference display with limited space, requiring concise, high-impact content. In addition to the Front Content, the Details section offers expanded capabilities, allowing you to include comprehensive information such as detailed terms and conditions, contact information, and web resources for your Members.

The Details section comprises the following two standard fields, as well as the ability to create additional custom sections:

  • Account Name: This field should contain the Member’s name.

  • Account ID: This field should contain the Member’s account ID.

The above two fields include a Label and a Value. Typically the Label is smaller, and contains static text. The Value is larger, and will often contain a dynamic value populated by means of a Content Token.

To configure the Details section:

  1. Select the Google tab, then select the Details tab.

  2. For the Account Name field, enter the following details.

    • Label: Enter either a static value or type “@” to pull up a list of Content Tokens, and select a Content Token. This value appears in a smaller font size than the Value.

    • Value: Enter either a static value or type “@” to pull up a list of Content Tokens, and select a Content Token. This value represents the main text for this field, and is displayed in a larger font size than the Label.

  3. For the Account ID field, enter the Label and Value as described above.

  4. Optionally, to add a new section, click Add New Section.

  5. From the Type drop-down menu, select the desired content type:

    • Fixed Text: Used for static content like terms and conditions or privacy policies. This content type supports HTML formatting for clickable links and text styling.

    • Stores / Locations: Help your customers find your nearest stores by showing location-based information.

    • Custom: Create personalized content using Content Sources. These Content Sources must be pre-configured in the Advanced Options tab (see Configure Store Card / Loyalty Pass Advanced Options for details).

  6. In the Header field, enter a descriptive title for this section.

  7. In the Template field, enter either simple text content, or define advanced dynamic content using Liquid syntax.

Note: For additional help on creating Liquid templates, a Templating Guide link is displayed within the Details tab. This guide provides code samples to support several different use cases, such as listing valid Offers, or displaying the balance of a Gift Card. If using Liquid templating, please be sure your Content Sources and Content Tokens are defined, and all Content Sources have been added in the Advanced Options tab of the Wallet Pass.

  1. Repeat the above steps as needed to add more sections to the Loyalty Pass Details section.

  1. Click Save Changes.

To add links to the Google Loyalty Pass:

  1. Select the Google tab, then select the Links tab.

  2. Click Add New Link.

  3. In the URI field, enter the link’s URI (Uniform Resource Identifier); ensure that this is a valid, working destination.

  4. In the Description field, enter a clear descriptive label that tells Members what to expect when they tap the link.

  1. Repeat the above steps as needed to add more links.

  2. Click Save Changes.

Settings

The Settings tab provides essential controls for managing how Members can share and access Wallet Passes across different devices. These security settings are crucial for maintaining the integrity of your Wallet Pass distribution system and ensuring appropriate access control.

For Google devices, you can configure pass sharing through three distinct permission levels:

  • Multiple Holders (Unrestricted Sharing)

    • Allows multiple Members to access the Wallet Pass on different devices

    • Ideal for promotional passes or general-access memberships

    • Provides maximum flexibility for pass distribution

  • One User All Devices (Single User, Multiple Devices)

    • Restricts pass access to a single Member

    • Allows that Member to access the Wallet Pass across all their devices

    • Recommended for personal membership passes or loyalty programs

  • One User One Device (Restricted Access) - Not Available

    • Intended for use by select Google partners in limited circumstances; please select one of the above levels instead.

To configure the permission settings for your Google Loyalty Pass:

  1. Select the Google tab, then select the Settings tab.

  2. From the Device and Users Allowed Status drop-down menu, select the desired permission level, as described above.

  3. Click Save Changes.

Test Preview

To properly test your Google Wallet Pass, you need access to a Google device. This method provides the most authentic testing experience.

Prior to testing, you must ensure that you have at least one Test Member available in your Loyalty instance. Designating a Member as a Test Member is available on the Member Profile screen (see Edit Member Attributes for more information).

To test a Google Wallet Pass:

  1. Select the Google tab, then select the Test Preview tab.

  2. From the Member drop-down menu, choose the desired Test Member.

  3. Click Add to Google Wallet. A confirmation dialog box is displayed; click Add.

  4. An alert is displayed, indicating “This is a mock success. Wallet Pass has been saved to Google Pay.”

  5. Click View Loyalty Card to view the Google Wallet Pass contents in a new browser tab.