Customize Checkout
Customize the appearance and behavior of Checkout.
Customize Checkout with your branding, configure legal and return policies, enable customer payment autofill, and so on.
Customize the appearance![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can customize the look and feel of Checkout from the Dashboard.
Apply branding ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can apply custom branding to Checkout. Go to Branding Settings to:
- Upload a logo or icon (only applies to Checkout’s Stripe-hosted page)
- Customize the Checkout page’s background color, button color, font, and shapes
Read about font compatibility to learn which fonts Checkout supports in different locales.
Branding with Connect![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
For platforms performing direct charges, and destination charges with on_
, Checkout uses the brand settings of the connected account. Platforms can configure the brand settings of connected Express and Custom accounts using the Accounts API.
Change your brand name![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can change a Checkout page’s name by modifying the Public business name field in public settings.
You can also customize the domain name of a Stripe-hosted Checkout page.
Customize text and policies![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can customize the text that your customers see, as well as the policies Checkout displays.
Add custom text![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can present additional text to customers when they pay with Stripe Checkout, such as shipping and processing times.
Warning
You are prohibited from using this feature to create custom text that will violate or create ambiguity with the Stripe generated text on Checkout, obligations under your Stripe agreement, Stripe’s policies, and applicable laws.
![Custom text near shipping address collection](https://b.stripecdn.com/docs-statics-srv/assets/shipping-address-custom-text.b0b578d66d2bd415d0b0fe03106d27df.png)
Custom text near the shipping address collection fields
![Custom text above the pay button](https://b.stripecdn.com/docs-statics-srv/assets/submit-custom-text.bf46135c06b7c33c1ce9c9b09e4206c9.png)
Custom text above the Pay button
![Custom text below the pay button](https://b.stripecdn.com/docs-statics-srv/assets/custom-text-after-submit.32dbd97008b3f189145bcd07c4562bb4.png)
Custom text after the Pay button
Your custom text can be up to 1200 characters in length. However, Stripe Checkout is optimized for conversion, and adding extra information might affect your conversion rate. You can bold text or insert a link using Markdown syntax.
Customize policies and contact information ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can display your return, refund, legal policies, and support contact information to your customers on Checkout. Go to Checkout Settings to configure the information you want to display, including:
- Details about your return and refund policies
- Your support phone number, email, and website
- Links to your terms of service and privacy policy
Presenting this information can increase buyer confidence and minimize cart abandonment.
Configure support and legal policies![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
From Checkout Settings, add support contact information to your sessions by enabling Contact information. Similarly, add links to your Terms of service and Privacy policy to your sessions by enabling Legal policies. If you require customers to implicitly consent to your legal policies when they complete their checkout, select the Display agreement to legal terms checkbox.
You must add your support contact information and legal policy links in your Public Detail Settings.
The following previews show how Checkout displays a dialog with the support contact information, links to the store legal policies, and information about the payment terms.
![A checkout page with contact information.](https://b.stripecdn.com/docs-statics-srv/assets/contact-modal.2b81bc2e74657f7c94a45a743439c81f.png)
Preview of contact information on Checkout.
![A checkout page with legal policies.](https://b.stripecdn.com/docs-statics-srv/assets/legal-modal.9351cb51408c2a9f5c0ae23aab03e138.png)
Preview of legal policies on Checkout.
Configure return and refund policies![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Display your return, refund, or exchange policies, by enabling Return and Refund policies. Although businesses that sell physical goods use return policies, businesses that sell digital goods or customized physical goods typically use refund policies. Because they’re not mutually exclusive, you can select both options if your business sells both categories of goods. You can edit your return and refund details, including:
- Whether you accept returns, refunds, or exchanges
- Whether returns, refunds, or exchanges are free or if they’re subject to a fee
- How many days after a purchase you’ll accept returns, refunds, or exchanges
- How customers can return items shipped to them
- Whether you accept in-store returns
- A link to the full return and refund policy
- A custom message
If you accept free returns, refunds, or exchanges, Checkout highlights the policy for customers.
The following previews show how Checkout displays a return policy. In this example, it’s for purchases that can be returned by shipping them or in-store for a full refund (or exchange) for up to 60 days. You can display similar information for refunds.
![Preview of return policies on Checkout](https://b.stripecdn.com/docs-statics-srv/assets/return-policy-modal.0c7a9ff71b8bc2c155842532801e06a8.png)
Preview of return policies on Checkout.
![Preview of a policy highlight on Checkout](https://b.stripecdn.com/docs-statics-srv/assets/policy-highlight.334828420693a33d376977a2c0fe5851.png)
Preview of a policy highlight on Checkout.
Collect a terms of service agreement![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Businesses often require their customers to agree to their terms of service before they can pay. This might depend on the type of product or subscription. Checkout helps you collect the necessary agreement by requiring a customer to accept your terms before paying.
![Collect terms of service agreement](https://b.stripecdn.com/docs-statics-srv/assets/terms-of-service-consent-collection.dec90bde6d1a3c5d4c0b3e7b8e644a52.png)
Collect terms of service agreement
You can collect a terms of service agreement with Stripe Checkout when you create a Session:
When consent_
, Checkout dynamically displays a checkbox for collecting the customer’s terms of service agreement. If consent_
, Checkout won’t display the checkbox and won’t require customers to accept the terms of service. Before requiring agreement to your terms, set your terms of service URL in your business’ Public details. Setting a privacy policy URL is optional—Checkout also links to your privacy policy when a URL to your Privacy policy is set in your Public details.
After a customer completes checkout, you can verify that the customer accepted your terms of service by looking at the Session object in the checkout.
webhook, or by retrieving the Session using the API. When the terms are accepted, the Session’s consent.terms_of_service field is set to accepted
.
You can customize the text that appears next to the checkbox by using custom_
. You need to set consent_
. To use your own terms, insert a Markdown link. For example: I agree to the [Terms of Service](https://example.
Warning
Consult your legal and compliance advisors before making any changes to this text. You may not use this feature to display custom text that violates or creates ambiguity with the Stripe-generated text on Checkout, obligations under your Stripe agreement, Stripe policies, and applicable laws.
Collect consent for promotional emails![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can send promotional emails to inform customers of new products and to share coupons and discounts. Before doing so, you must collect their consent to receive promotional emails.
Customize checkout behavior![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can customize how Checkout behaves during the payment process. These changes can help increase conversion and boost revenue.
Customize the Submit button ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To better align Checkout with your business model, configure the copy displayed on the Checkout submit button for one-time purchases.
Define a submit_
on your session. In this example (for a 5 USD donation), your customized Checkout submit button would read Donate $5.00. See the API reference for a complete list of submit_
options.
Localization and supported languages ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
By default, Checkout detects the locale of the customer’s browser and displays a translated version of the page in their language, if it is supported. You can override the browser locale for Checkout by passing the locale
parameter when you create a Checkout Session.
Checkout also uses the locale to format numbers and currencies. For example, when selling a product whose price is set in EUR with the locale set to auto
, a browser configured to use English (en
) would display €25.00 while one configured for German (de
) would display 25,00 €.
Autofill payment details with Link ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can automatically use Link (Stripe’s one-click checkout) in your prebuilt Checkout page. To learn more, see Link with Checkout.