# Branding your Stripe account

Customize the appearance of your Stripe account and customer-facing elements.

Customize the appearance of your emails, checkout, payment links, customer portal, and invoices in your [Branding settings](https://dashboard.stripe.com/account/branding).

> #### Customize with an agent
> 
> You can view and update your branding settings with the [Stripe CLI](https://docs.stripe.com/stripe-cli.md) or the [Stripe MCP server](https://docs.stripe.com/mcp.md). To find the available operations, run `stripe tools search branding` in the CLI, or ask your AI agent to search for `branding` using Stripe MCP.
[Watch on YouTube](https://www.youtube.com/watch?v=IWpbEcdocUI)
## Branding

Icons and logos must be in JPG or PNG format, less than 512kb in size, and equal to or greater than 128px by 128px.

- **Icon**—A square, digital-friendly icon or logo.
- **Logo**—A non-square logo to override some uses of the icon.
- **Brand color**—Used on receipts, invoices, and the customer portal.
- **Accent color**—Used as a background on emails and pages.

### Apply brand settings 

Brand settings apply to your whole account and take effect in many places.

| Setting | Emails | Checkout & Payment Links | Customer portal | Hosted invoice page | Invoice PDFs |
| --- | --- | --- | --- | --- | --- |
| **Icon** | Yes | Yes | Yes | Yes | Yes |
| **Logo** | No | Yes | No | No | Yes |
| **Brand color** | Yes | No | Yes | Yes | Yes |
| **Accent color** | Yes (background color) | Yes | Yes | Yes | No |

### Branding with Connect

Connect platforms can configure a connected account’s branding using [configuration.merchant.branding](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-merchant-branding) (with the Accounts v2 API) or [settings.branding](https://docs.stripe.com/api/accounts/object.md#account_object-settings-branding) (with the Accounts v1 API). The branding of a given user interface depends on the integration:

- For integrations that use *direct charges* (A charge type where customers transact directly with a connected account, which is always the merchant of record. With each payment, the connected account pays fees to Stripe and, optionally, to your platform), where objects usually exist on connected accounts, most interfaces use the connected account’s branding. Connect-related emails sent to a connected account, such as risk or onboarding communications, are an exception. Those emails use the platform’s branding.
- For integrations that use *indirect charges* (A charge type where customers transact directly with your platform instead of with a connected account. Indirect charges include destination charges and separate charges and transfers) without setting `on_behalf_of`, interfaces use the platform’s branding settings unless explicitly overridden (such as when specifying a Checkout Session’s [branding_settings](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-branding_settings))
- For integrations that use indirect charges and set `on_behalf_of`, most interfaces use the connected account’s branding settings unless explicitly overridden. Connect-related emails sent to a connected account, such as risk or onboarding communications, are an exception. If you use the *customer portal* (The customer portal is a secure, Stripe-hosted page that lets your customers manage their subscriptions and billing details), you need to set [on_behalf_of](https://docs.stripe.com/api/customer_portal/sessions/create.md#create_portal_session-on_behalf_of) on the `CustomerPortalSession`. The customer portal only includes subscriptions and invoices whose `on_behalf_of` matches the value set on the session.

> #### Self-branding
> 
> Connect platforms and non-Connect users can’t configure their own branding using the Accounts API. They need to use the Dashboard.

## Customize policies and contact information 

You can display your return, refund, and legal policies, and your support contact information to your customers on Checkout. Go to [Checkout Settings](https://dashboard.stripe.com/settings/checkout) 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 customer confidence and minimize cart abandonment.

### Configure support and legal policies

From [Checkout Settings](https://dashboard.stripe.com/settings/checkout), 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](https://dashboard.stripe.com/settings/public).

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

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.

## Other customization options

- **Custom domains**

  Checkout, Payment Links, and customer portal pages use stripe.com as the default domain. You can optionally set up your own [custom domain](https://docs.stripe.com/payments/checkout/custom-domains.md) for those products.

- **Custom email domain**

  By default, when Stripe sends invoices, receipts, and failed payment notifications to your customers, it sends them from the stripe.com domain. Set up your own [custom domain](https://docs.stripe.com/get-started/account/email-domain.md) to change this.

- **Payments, debits, and bank transfer emails**

  You can decide which emails your customers receive about payments, debits, and bank transfers in your [Customer emails settings](https://dashboard.stripe.com/settings/emails). You can also choose the default language to use for emails when you don’t know a customer’s preference.

- **Billing (subscription and invoicing) emails**

  You can turn on customer emails for [Billing](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md) and [Invoicing](https://docs.stripe.com/invoicing/send-email.md) in the Dashboard or through the API.