# Brand guidelines

The following guidelines show how to include the Google Pay brand within your websites.

## Google Pay payment buttons

The Google Pay payment button must always call the Google Pay API. The Google Pay API then calls
the payment sheet where users can select their payment method.
**Note:** Use our [Customize your button](https://developers.google.com/pay/api/web/guides/resources/customize) tool to configure a button for your website.

### Assets

The [`createButton()`](https://developers.google.com/pay/api/web/reference/client#createButton)
JavaScript method dynamically inserts CSS rules and an SVG file from the Google CDN for an
HTML `<button>` element.

When you use the [`createButton()`](https://developers.google.com/pay/api/web/reference/client#createButton)method, you get:

- **Brand Compliance:** Seamlessly integrate a Google Pay payment button that automatically adheres to the latest Google Pay branding guidelines while offering customizable options to match your UI design with minimal effort.
- **Customizable Shape:** Fine-tune the button's corner roundness to seamlessly match your existing design aesthetic.
- **Localized Experience:** The button's caption automatically translates to the user's browser language, enhancing accessibility.
- **Personalized for Users:** Help users discover available payment methods in their Google Pay wallet for a faster checkout process.

If this convenience method or the supported languages don't suit your needs,
[contact us](https://developers.google.com/pay/api/web/support/how-to-get-help).

### Style

All Google Pay payment buttons exist in two styles: dark and light. You can see examples of both
styles in the [Assets section](https://developers.google.com/pay/api/web/guides/brand-guidelines#logo-mark-assets). The Google Pay brand name must not
be translated. Don't create buttons with your own localized text.

|---|---|---|
| **Button Type** | **Dark** | **Light** |
| **book** | ![Dark Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/book-button-dark-pill-shape.png) | ![Light Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/book-button-white-pill-shape.png) |
| **buy** | ![Dark Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/buy-button-dark-pill-shape.png) | ![Light Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/buy-button-white-pill-shape.png) |
| **checkout** | ![Dark Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/checkout-button-dark-pill-shape.png) | ![Light Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/checkout-button-white-pill-shape.png) |
| **donate** | ![Dark Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/donate-button-dark-pill-shape.png) | ![Light Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/donate-button-white-pill-shape.png) |
| **order** | ![Dark Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/order-button-dark-pill-shape.png) | ![Light Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/order-button-white-pill-shape.png) |
| **pay** | ![Dark Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/pay-button-dark-pill-shape.png) | ![Light Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/pay-button-white-pill-shape.png) |
| **plain** | ![Dark Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/plain-button-dark-pill-shape.png) | ![Light Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/plain-button-white-pill-shape.png) |
| **subscribe** | ![Dark Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/subscribe-button-dark-pill-shape.png) | ![Light Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/subscribe-button-white-pill-shape.png) |
| Use the button type verbiage that best suits your checkout page. | Use dark buttons on light backgrounds to provide contrast. | Use light buttons on dark or colorful backgrounds. |

### Personalization

When users have an eligible card on their Google Pay account, the "Buy", "Pay" and "Plain"
payment buttons will display the card network and the last four digits of the card number. The
card network will be displayed in the same position as the "Buy with" or "Pay with" text.

|---|---|---|
| **Button Type** | **Dark** | **Light** |
| **buy, pay and plain** | ![Dark Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/dynamic-dark-pill-shape.png) | ![Light Google Pay payment buttons](https://developers.google.com/static/pay/api/images/brand-guidelines/dynamic-white-pill-shape.png) |
| Use the buy, pay or plain button type to enable personalization. | Use dark buttons on light backgrounds to provide contrast. | Use light buttons on dark or colorful backgrounds. |

### Custom button


Use the following tool to preview the appearance of each button:
<iframe src="https://gpay-live-demo.web.app/customize.html" allow="payment" frameborder="0" height="760" width="100%"></iframe>

> [!CAUTION]
> **Important:** Use of the "Donate with Google Pay" asset requires additional Non-Profit Organization validation during onboarding.

### Clear space

Always maintain the minimum clear space of 8 dp on all sides of the payment button. Ensure the
clear space is never broken with graphics or text.
![Google Pay payment button clear space example for Android](https://developers.google.com/static/pay/api/images/brand-guidelines/android-clear-space.png)

**Examples**
![Correct button spacing](https://developers.google.com/static/pay/api/images/brand-guidelines/button-placement-examples.png)

|---|---|
| If you place a Google Pay button next to another button, make sure the Google Pay button is equal in size to the other button. | Always use a Google Pay button that contrasts with the background on which it appears. |

![Button size adjustment](https://developers.google.com/static/pay/api/images/brand-guidelines/button-size-example.png)

|---|---|
| When you adjust the size of the Google Pay button, always keep its proportions consistent. |   |

### Dos and Don'ts

| Do | Don't |
|---|---|
| - Use only the Google Pay buttons provided by Google. - Use the Google Pay buttons to initiate the payment flow. - Use the same style of button throughout your site. - Ensure that the size of the Google Pay buttons remains equal to or larger than other buttons. - Display the Google Pay buttons with equal prominence to other buttons. - Always choose a button color that contrasts with your background. | - Don't create your own Google Pay buttons or alter the font, color, button radius, or padding within the button in any way. - Don't use Google Pay payment buttons to begin any action other than the payment flow. - Don't switch between different color styles - Don't switch between versions with and without text. - Don't use a button color that's similar to the background. For example, don't use the white button on a white background. |

## Google Pay mark

Use only the Google Pay
[mark](https://developers.google.com/pay/api/web/guides/brand-guidelines#mark) that's provided in these guidelines when you show Google Pay as an
option in your payment flows.

### Assets

Click the following button to download the Google Pay mark in an SVG file format:
[Download assets](https://developers.google.com/static/pay/api/download-assets/Google-Pay-Acceptance.zip)

### Mark

Use the following Google Pay mark when you show Google Pay as a payment option:
![Google Pay mark](https://developers.google.com/static/pay/api/images/brand-guidelines/google-pay-mark.png)

Display "Google Pay" in text next to the mark if you do so for other brands. Don't change the
color or weight of the mark's outline, or alter the mark in any way. Use only the mark provided by
Google.

### Clear space

Always maintain at least half (0.5x) of the height of the capital G on all sides of the Google Pay
acceptance mark. Make sure the clear space is even with any other brand identities that you
display.
![Google Pay mark clear space example](https://developers.google.com/static/pay/api/images/brand-guidelines/clear-space-mark.png)

### Size

Adjust the height to match the other brand identities displayed in your payment flow. Don't make
the Google Pay mark smaller than other brand identities.
![](https://developers.google.com/static/pay/api/images/brand-guidelines/payment-option-credit-card.png) Use the Google Pay mark to represent Google Pay as a payment option throughout your buy flow.

### Dos and Don'ts

| Do | Don't |
|---|---|
| - Use only the Google Pay mark provided by Google. - Use the Google Pay mark to indicate Google Pay as a payment option in payment flows. | - Don't create your own mark or alter it in any way. - Don't translate the word "Pay." - Don't display the Google Pay mark in a different or smaller size than the other payment options. |

## Google Pay in text

You may use text to indicate Google Pay as a payment option, and to promote Google Pay in your
marketing communication.

Capitalize the letters "G" and "P"
:   Always use an uppercase "G" and an uppercase "P" followed by lowercase letters. Don't capitalize
    the full name "GOOGLE PAY" unless it's to match the typographic style on your website. Never use
    an uppercase "GOOGLE PAY" in your marketing communication.

Don't abbreviate Google Pay
:   Always write out the words "Google" and "Pay."

Match the style on your website
:   Set "Google Pay" in the same font and typographic style as the rest of the text on your website.
    Don't mimic Google's typographic style.

Don't translate Google Pay
:   Always write "Google Pay" in English. Don't translate it into another language.

Use the trademark symbol the first time "Google Pay" appears in
marketing communication
:   When you use "Google Pay" in your marketing communication, show the trademark symbol, ™, the
    first or most prominent time that it appears. Don't use the trademark symbol when you list
    Google Pay as a payment option on your website.
![](https://developers.google.com/static/pay/api/images/brand-guidelines/payment-option-text-style.png)

|---|---|
| If you don't display brand identities for other payment options, then represent "Google Pay" with text. | Set "Google Pay" in the same font and typographic style as the rest of the text on your site. |

## Google Pay best practices

Maximize your conversions with checkout flows and payment sheets that let customers quickly and
easily review their payment information and confirm their purchase.

The following are best practices:

Make Google Pay the primary payment option.
:   Wherever possible, display the Google Pay button prominently. You can also make it the default
    option, or the only payment option.

Let your customers make purchases without an account
:   Account creation slows down the checkout process and can lead to abandoned
    carts. Use Google Pay to enable faster guest checkout. If you'd like your
    customers to create an account, allow them to do so after they complete
    their purchase.

Use Google Pay to initiate payment during cart checkout
:   The Google Pay button brings up the payment sheet. On the payment sheet, customers can only
    select and confirm a single payment method and shipping address. Be sure to get all the other
    information that you need before you give customers the option to select the Google Pay button.
    Other information can include the following:
:   If a customer doesn't provide the necessary information, offer real-time feedback to let them
    know what you need before they can bring up the payment sheet.

Add the Google Pay button to the product detail pages in addition to the cart checkout
:   You can speed up single-item checkout if you let customers make individual purchases
    right from your product detail pages. If a customer chooses this option, be
    sure to exclude any other items they have in their shopping cart because the
    payment sheet only lets them confirm their payment and shipping information.

Include Google Pay on confirmation pages and receipts
:   When you display payment information on confirmation pages and email receipts, make sure you
    indicate that the customer has paid with Google Pay, and that you display Google Pay
    in the same manner as other payment methods.
:   Never display full account numbers, expiration dates, or other payment method details to the
    user. Always use the descriptive text returned by the Google Pay API to identify the payment
    method.
:   The following are examples of acceptable descriptive text:

## Put it all together

The following image illustrates a completed integration. The integration also
includes the **Item selection** /**Pre-purchase** step, **Transaction** step,
**Google Pay selector** step, and **Post-purchase** step.
![Web buy flow experience](https://developers.google.com/static/pay/api/images/brand-guidelines/web-buy-flow.png) These screens represent a recommended Google Pay buy flow for a shopping cart experience.

## Get approval

Once you've integrated the Google Pay API, in order to gain production access, you need to
get approval for all the places where you display or reference Google Pay.

Complete our
[Integration
checklist](https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist) to submit your web integration for review. You should receive
approval or feedback within one business day.