Add to Apple Wallet Guidelines - Wallet - Apple Developer (2024)

View in English

The Add to Apple Wallet button and badge give users a visual cue to add passes, tickets, coupons, and more to the Wallet app on their Apple device. Follow these guidelines when using the button in your apps, web pages, and email, or when using the badge on printed materials.

Add to Apple Wallet Guidelines - Wallet - Apple Developer (1)

Using the Button or Badge

The Add to Apple Wallet artwork is designed to be used as a button in apps, web pages, and email, or as a badge along with a QR code on point-of-sale signage, coupons, posters, or other printed material. The button or badge should appear only in association with your Wallet‑compatible pass.

Format

Apps. Use the PKAddPassButton class to create an Add to Apple Wallet button for your Wallet-enabled app. You can choose the button’s style, and the system provides a control with the correct appearance and language. The button is available as a one-line button or two-line button.

Web, email, and print. Use the downloadable SVG artwork provided by Apple for buttons on your web pages and email. Use the EPS artwork for badges on printed materials.

Download artwork files

Localization

For apps, the PassKit API provides a localization of Add to Apple Wallet based on the user’s language settings. For web, email, and print, use the localized artwork provided by Apple. Do not create your own localized version.

Background Color

For apps, the PassKit API provides a black button without an outline. Use this button on white or light-colored backgrounds that provide sufficient contrast. With very dark backgrounds, use the outline option shown.

Clear Space

For onscreen layouts, the minimum clear space for the button is .1X where X is the height of the button. For print, see Printing the Badge with a Code.

Apps

Use the PKAddPassButton class to create an Add to Apple Wallet button for your Wallet-enabled app. Place the button directly on or near the item that can be stored in Wallet.

To learn more about making passes available to users, see the Human Interface Guidelines.

Email

Place the button on or near the pass that can be stored in Wallet. Users can add their pass to Wallet directly from email opened on their iPhone, iPod touch, or Mac. Because users might open the email on another device, include instructions for opening the email on iPhone, iPod touch, orMac.

Web Pages

Place the button on or near the pass that can be stored in Wallet. Users can add their pass to Apple Wallet directly from a web page opened on iPhone, iPod touch, or Mac. Because users might open the web page on another device, include instructions for opening the page on their iPhone, iPod touch, orMac.

Using the Badge on PrintedMaterials

In printed materials, the Add to Apple Wallet badge should appear only in association with a Wallet-compatible pass and must be accompanied by a QRcode or bar code. Customers can use the Camera app or Wallet app to scan the code on point-of-sale signage, coupons, posters, or other printed material. Scanning the code adds the pass to Wallet.

Cashpoint Sign

Place the Add to Apple Wallet badge and suggested messaging near the code. Place the badge on the layout so that it is clearly visible yet in a subordinate position following the main graphics and messages.

Poster

On large printed materials, the Add to Apple Wallet badge cannot be larger than the maximum height requirement of 25mm.

Printing the Badge withaCode

Clear Space and SizeRequirements

Minimum clear space is one-quarter the height of the badge. On printed materials, the minimum size for the Add to Apple Wallet badge is 10 mm in height and the maximum size is 25 mm in height. Do not reduce or enlarge the badge beyond these sizes.

QR Codes and Bar Codes

A recommended minimum code size for optimum scanning to Wallet is 40 mm wide. At this size QR codes of version 10 or lower, PDF 417 bar codes with five or fewer data columns, and Aztec codes of six or fewer data layers are recommended.

Badge and Code Alignment

It is recommended that the code and Add to Apple Wallet badge be aligned to equal width. It is also acceptable to have the codes left or center aligned.

White Space

Allow minimum clear space around the Add to Apple Wallet badge. Make sure you also comply with the requirements for a surrounding “quiet zone” for the type of code you are using. Codes must be printed on a white or light background. If your layout includes a dark background, do not extend the code’s required surrounding white space to include the Add to Apple Wallet badge. The white space should surround only the code. On dark backgrounds, the Add to Apple Wallet badge should not touch the code’s required surrounding white space.

Editorial Guidelines

Messaging that describes Wallet can be used in communications promoting Wallet-compatible passes. Messaging can be placed near the Add to Apple Wallet button or badge that accompanies your pass, or it can be used in general product communications to describe compatibility with Wallet.

Suggested Messaging

You can use the suggested messaging below to describe and promote Wallet, or you can develop your own copy. Always follow the guidelines for using the name Wallet described below.

  • Wallet description—long version:

    “The Wallet app on Apple Watch, iPhone, and iPod touch is where you store and access all your boarding passes, movie tickets, coupons, rewards cards, and more.”

  • Wallet description—short version:

    “Wallet is where you store and access all your boarding passes, movie tickets, retail coupons, rewards cards, and more.”

  • Instructions for adding a pass to Wallet if opened on a device other than iPhone or iPod touch:

    “To add this [pass/ticket/coupon/card] to Wallet, open this [email, web page] on your iPhone or iPod touch.”

  • Instructions for scanning a code—for use on printed materials:

    “Wallet on Apple Watch, iPhone, and iPod touch is where you store and access all your boarding passes, movie tickets, retail coupons, rewards cards, and more. Now you can even scan this code to have a [insert brand/type of pass here] appear right in Wallet. To scan, just open Wallet on your iPhone or iPod touch and select Scan Code.”

Using the Name Wallet or Apple Wallet

When using the app name Wallet or Apple Wallet in headlines or copy, always typeset Wallet with an uppercase W followed by lowercase letters. Typeset Apple with an uppercase A followed by lowercase letters. Apple Wallet is set as two words.

If a headline is typeset all uppercase, the words Apple Wallet within the headline can also be uppercase.

You can refer to the Wallet app from Apple or Apple Wallet on the first mention of the app. In subsequent references, just Wallet can be used.

In U.S. communications, use the registered trademark symbol (®) the first time Apple appears in body copy.

Avoid Mistakes

Only the Apple-provided buttons and badges shown in these guidelines are approved by Apple.

  • Do not let the Add to Apple Wallet badge dominate your layout as the primary message or main graphic. It must be secondary to your main message and product or company identity.
  • Do not create your own version of the Add to Apple Wallet button or badge.
  • Do not obstruct the badge or button with text, graphics, violators, or images.
  • Do not display a dimmed version of the badge or button to indicate that it has not been selected.
  • Do not use the Wallet icon alone.
  • Do not flip, rotate, or animate the artwork.
  • Do not add visual effects such as shadows, glows, or reflections to the mark.
  • Do not use graphics or images from Apple’s website.
  • Do not imitate Apple communications.

Legal Requirements

Add to Apple Wallet button and Wallet messaging cannot be used in any manner that falsely suggests an association with Apple or is likely to reduce, diminish, or damage the goodwill, value, or reputation associated with any Apple product or Apple itself.

Trademark Symbols and Credit Lines

For communications distributed only in the United States, the appropriate symbol (™, ℠, or ®) must follow each Apple trademark the first time it is mentioned in body copy—for example:

Apple Watch®
iPhone®
iPod touch®

Refer to the Apple Trademark List for the correct trademark symbol. Do not add a trademark symbol to the Add to Apple Wallet button artwork provided by Apple.

In all regions, include the following credit line wherever legal information is provided on the communication:

Apple, Apple Watch, iPhone, and iPod touch are trademarks of Apple Inc., registered in the U.S. and other countries.

List only the trademarks actually used in your communication.

For more information about using Apple trademarks, see Guidelines for Using Apple Trademarks and Copyrights.

With Apple’s approval, a translation of the legal notice and credit lines (but not the trademarks) can be used in materials distributed outside the United States.

PLEASE READ THE FOLLOWING APPLE WALLET MARKETING ARTWORK LICENSE AGREEMENT ("WALLET MARKETING AGREEMENT") CAREFULLY BEFORE DOWNLOADING OR USING THE APPLE ARTWORK (AS DEFINED BELOW). THESE TERMS AND CONDITIONS CONSTITUTE A LEGAL AGREEMENT BETWEEN YOU AND APPLE.

BY CHECKING THE APPROPRIATE BOX ON THE APPLE DEVELOPER WEBSITE, YOU REPRESENT THAT YOU ARE AN AUTHORIZED REPRESENTATIVE FOR YOUR DEVELOPER ACCOUNT AND THAT YOU HAVE READ AND AGREE TO THE TERMS OF THIS WALLET MARKETING AGREEMENT.

Apple Wallet Marketing Artwork License Agreement

Whereas, Apple Inc. ("Apple") and You (collectively, the "Parties") have entered into the Apple Developer Program License Agreement (as amended from time to time, "Program Agreement"); and

Whereas, You desire to use certain artwork in connection with marketing Your passes pursuant to the Program Agreement, the Parties agree to enter into this Wallet Marketing Agreement effective as of the date clicked through by You.Except as expressed in writing herein, nothing in this document shall be construed to modify the Program Agreement in any way.

1. Subject to the terms of this Wallet Marketing Agreement, Apple grants You a limited, non-exclusive, non-transferable, royalty-free, worldwide license to use the "Add to Apple Wallet" badge and product images provided to You by Apple under this Wallet Marketing Agreement for Apple-branded products (collectively, the "Artwork") only in connection with Your passes developed pursuant to the Program Agreement ("Passes") and only while You are a member of the Apple Developer Program.

2. You agree that Your use of the Artwork will be in strict compliance with the Add to Apple Wallet Guidelines available at: developer.apple.com/wallet/, which may be amended from time to time and also with Apple’s Guidelines for Using Apple Trademarks and Copyrights, found at https://www.apple.com/legal/intellectual-property/guidelinesfor3rdparties.html, which may be amended from time to time.

3. Apple may use Your name, address, the name of each of Your Passes, and other relevant Pass information in any index of products or developers that work with Apple-branded products running iOS and/or Wallet.

4. Apple has no obligation to provide any type of support for the Passes.

5. Upon Apple’s request, You shall supply Apple, at no cost and with no obligation to return, suitable specimens of Your use of the Artwork to verify Your compliance with this Wallet Marketing Agreement.

6. Apple shall remain the exclusive owner of all rights in the Artwork. Your use of the Artwork shall exclusively inure to the benefit of Apple. You will not do anything to compromise Apple’s rights in and to the Artwork, such as filing any identical or confusingly similar trademark applications anywhere in the world.

7. THE ARTWORK IS PROVIDED TO YOU ON AN "AS IS" BASIS AND YOU ARE SOLELY RESPONSIBLE FOR YOUR USE OF THE ARTWORK. APPLE DISCLAIMS ALL WARRANTIES REGARDING THE ARTWORK, INCLUDING WARRANTIES OF NON-INFRINGEMENT. APPLE SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR PUNITIVE DAMAGES ARISING FROM OR RELATED TO YOUR USE OF THE ARTWORK, OR TERMINATION OF THIS WALLET MARKETING AGREEMENT.

8. To the extent permitted by applicable law, You agree to indemnify and hold harmless, and upon Apple’s request, defend, Apple, its directors, officers, employees, independent contractors and agents (each an "Apple Indemnified Party") from any and all claims, losses, liabilities, damages, taxes, expenses and costs, including without limitation, attorneys’ fees and court costs, incurred by an Apple Indemnified Party and arising from or related to Your use of the Artwork in any manner except as expressly permitted by this Wallet Marketing Agreement, or for any personal injury, product liability or other claim arising from the production, promotion, distribution, use, sale and/or offer for sale, and/or the performance of the Passes.

9. This Wallet Marketing Agreement is valid and coterminous with the Program Agreement, unless otherwise terminated per the provisions below.

10. This Wallet Marketing Agreement shall terminate automatically upon Your breach of any of the terms of this Wallet Marketing Agreement or any other marketing agreement You have entered into with Apple. Apple may terminate this Wallet Marketing Agreement at will upon 10 days’ written notice. If Apple terminates this Wallet Marketing Agreement, You may, except in the event that the Artwork is subject of a claim of infringement, deplete existing inventory for a period of 30 days following the notice of termination, provided such inventory is in compliance with the terms of this Wallet Marketing Agreement.

11. Any litigation or other dispute resolution between You and Apple arising out of or relating to this Wallet Marketing Agreement will take place in the Northern District of California, and You and Apple hereby consent to the personal jurisdiction of and exclusive venue in the state and federal courts within that District with respect any such litigation or dispute resolution. This Wallet Marketing Agreement will be governed by and construed in accordance with the laws of the United States and the State of California, except that body of California law concerning conflicts of law.

(a) Notwithstanding the foregoing, if You are an agency, instrumentality or department of the federal government of the United States, then this Wallet Marketing Agreement shall be governed in accordance with the laws of the United States of America, and in the absence of applicable federal law, the laws of the State of California will apply. Further, and notwithstanding anything to the contrary in this Wallet Marketing Agreement (including but not limited to Section 8), all claims, demands, complaints and disputes will be subject to the Contract Disputes Act (41 U.S.C. §§601-613), the Tucker Act (28 U.S.C. § 1346(a) and § 1491), or the Federal Tort Claims Act (28 U.S.C. §§ 1346(b), 2401-2402, 2671-2672, 2674-2680), as applicable, or other applicable governing authority.

(b) If You (as an entity entering into this Wallet Marketing Agreement) are a U.S. public and accredited educational institution, then (a) this Wallet Marketing Agreement will be governed and construed in accordance with the laws of the state (within the U.S.) in which Your educational institution is domiciled, except that body of state law concerning conflicts of law; and (b) any litigation or other dispute resolution between You and Apple arising out of or relating to this Wallet Marketing Agreement will take place in federal court within the Northern District of California, and You and Apple hereby consent to the personal jurisdiction of and exclusive venue of such District unless such consent is expressly prohibited by the laws of the state in which Your educational institution is domiciled; and

(c) If You are an international, intergovernmental organization that has been conferred immunity from the jurisdiction of national courts through Your intergovernmental charter or agreement, then any controversy or claim arising out of or relating to this Wallet Marketing Agreement, or the breach thereof, shall be determined by arbitration administered by the International Centre for Dispute Resolution in accordance with its International Arbitration Rules. The place of arbitration shall be London, England; the language shall be English; and the number of arbitrators shall be three. Upon Apple’s request, You agree to provide evidence of Your status as an intergovernmental organization with such privileges and immunities.

12. You shall promptly notify Apple in writing of any change in Your physical or electronic address via the App Store Connect tool and/or your account on the developer website.

13. The terms of this Wallet Marketing Agreement are the entire and final understanding between You and Apple concerning the Artwork.

EA0956

10/1/12

Add to Apple Wallet Guidelines - Wallet - Apple Developer (2024)

References

Top Articles
Latest Posts
Article information

Author: Geoffrey Lueilwitz

Last Updated:

Views: 5824

Rating: 5 / 5 (60 voted)

Reviews: 83% of readers found this page helpful

Author information

Name: Geoffrey Lueilwitz

Birthday: 1997-03-23

Address: 74183 Thomas Course, Port Micheal, OK 55446-1529

Phone: +13408645881558

Job: Global Representative

Hobby: Sailing, Vehicle restoration, Rowing, Ghost hunting, Scrapbooking, Rugby, Board sports

Introduction: My name is Geoffrey Lueilwitz, I am a zealous, encouraging, sparkling, enchanting, graceful, faithful, nice person who loves writing and wants to share my knowledge and understanding with you.