Setting up Geo Locations for Wallet cards

Geo Locations let you trigger a message on a member's lock screen when they are near a specific store or location. Messages are displayed directly on their wallet card and can be personalized based on the member's data.

Prerequisites

• A published wallet card in Design Studio
• Latitude and longitude coordinates set on Administration > Stores > Edit Store

How Geo Locations work

Location limit

Each card supports a maximum of 10 Geo Locations per member.

Fixed vs. calculated locations

There are two types of Geo Locations on a card:

• Fixed locations — locations you define manually that are shown to all members regardless of where they are
• Calculated locations — the remaining slots (up to 10 total) are filled automatically with the closest stores to the member's Regular Store, so each member sees the most relevant locations for them

For example, if you configure three fixed locations, the remaining seven slots are filled with the stores closest to each member's Regular Store.

Setting up a Geo Location

Geo Locations are configured on the wallet card design page in Design Studio, under Location Settings.

1. Open your card in Design Studio.
2. Navigate to Location Settings.
3. Write your location message — maximum 125 characters.
4. Optionally add personalized fields to make the message relevant to each member, for example including their name or points balance.
5. Set localization if your card is used across multiple markets. The message will be shown in the member's language.
6. Configure display conditions if you want to show different messages based on member data — see below.

Display conditions

Display conditions let you show different messages to different members based on their data at the time the Geo Location is triggered.

Example use case:

• If the member has an active voucher → "You have a voucher waiting — use it in store today"
• If the member does not have a voucher → "You're near us — come in and earn points on your next purchase"

Setting up a display condition

1. In the location settings, click Add condition.
2. Select the customer attribute to evaluate, for example voucher status, points balance, or membership level.
3. Define the condition and write the corresponding message.
4. Add a default message as a fallback for members who don't match any condition.
5. Save.

Best practices

• Keep messages short and actionable. You have 125 characters and members will see this on their lock screen.
• Use personalized fields to make the message relevant, for example referencing a voucher value or points balance.
• Set up display conditions to avoid sending irrelevant messages. A member with an active voucher should receive a different message from one who doesn't.
• Review your fixed locations regularly. If a store closes or moves, update the location to avoid triggering messages for a store that no longer exists.