Group multiple passes
Stay organized with collections
Save and categorize content based on your preferences.
Use a grouping ID
By default, adding multiple passes to a single
Add to Google Wallet link will not group those passes in the
user's Google Wallet app. However, passes can be grouped together by making
sure they all have the same grouping ID. Grouped passes will appear together
in the Google Wallet app. When a group of passes is selected, each pass will
be shown on a carousel.
Passes can be grouped together:
- During initial provisioning
-
By using the
update
or
patch
methods
To add a pass to a group, the groupingInfo.groupingId property of
the pass object must be set. All pass objects with the same
groupingId value will be automatically grouped together, even if
they were added separately.
The following example shows a loyalty card and offer being grouped together to
entice the user to make use of both in their next purchase.
loyaltyObject = {
"classId": "ISSUER_ID.GIFT_CARD_CLASS_SUFFIX",
"id": "ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX",
"state": "ACTIVE",
"groupingInfo": {
# Note the same groupingId value
"groupingId": "combinedGiftCardAndOfferId",
"sortIndex": 1
},
"barcode": {
"type": "QR_CODE",
"value": "QR code"
},
"accountId": "Account id",
"accountName": "Account name",
"loyaltyPoints": {
"label": "Points",
"balance": {
"int": 800
}
}
}
offerObject = {
"classId": "ISSUER_ID.OFFER_CLASS_SUFFIX",
"id": "ISSUER_ID.OFFER_OBJECT_SUFFIX",
"state": "ACTIVE",
"groupingInfo": {
# Note the same groupingId value
"groupingId": "combinedGiftCardAndOfferId",
"sortIndex": 2
},
"barcode": {
"type": "QR_CODE",
"value": "QR code",
},
}
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-04-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-14 UTC."],[[["By default, multiple passes added to Google Wallet are not grouped; however, you can group them using a `groupingId`."],["Grouped passes appear together in the Google Wallet app and can be provisioned together or grouped later using the `update` or `patch` methods."],["To group passes, ensure the `groupingInfo.groupingId` property is the same for all passes you want to group."],["Setting the same `groupingId` for different pass types like loyalty cards and offers allows you to create combined experiences for users."]]],["Passes in Google Wallet can be grouped by assigning them a shared `groupingId`. This can be done during the initial provisioning or later using `update` or `patch` methods. Setting the `groupingInfo.groupingId` property in each pass object ensures they are grouped. Passes with the same `groupingId` appear together in the user's wallet and are shown on a carousel when selected. The example shows a loyalty card and an offer using \"combinedGiftCardAndOfferId\" to be grouped.\n"]]
