Checkout Branding

Checkout branding lets you match your checkout pages to your brand. Choose a background color, button color, font, and border style at the account level, and optionally override them per checkout link or per checkout session via the API.

Try the checkout playground

Preview background color, button color, font, and border style on a live checkout before you apply them.

What you can customize

Setting	Description
Background color	A hex color code applied to the order summary panel on the checkout page (e.g. `#F4F4F5`)
Button color	A hex color code for the button color (e.g. `#FF5733`)
Font family	`system` (default), `roboto`, or `open_sans`
Border style	`rounded` (default), `pill`, or `rectangular`

Global branding

Global branding applies to every checkout link for your business. Individual links inherit these settings unless they have their own overrides.

Go to Dashboard > Settings > Checkout Branding
Choose your background color, button color, font, and border style
Use the live preview to see how your checkout will look
Select Save

Per-link overrides

Override the global branding on a specific checkout link. Useful when a particular product or campaign needs a different look.

Go to Dashboard > Checkout Links
Edit the checkout link you want to customize
In the Checkout branding section, adjust any setting
Save your changes

Any setting left on Global default inherits from account branding. Only the settings you explicitly change are overridden for that link.

Per-link branding takes precedence over global branding. If you update your global settings later, any link with its own overrides keeps its custom values for the overridden settings.

Customize individual checkout sessions

Set branding on individual checkout sessions using the checkoutStyling parameter when creating a checkout session. Session-level branding takes the highest precedence. The resolution order is: checkout session > checkout link (plan) > account defaults.

mutation {
	createCheckoutSession(
		input: {
			planId: "plan_XXXXXXXXX"
			checkoutStyling: {
				backgroundColor: "#F4F4F5"
				buttonColor: "#FF5733"
				fontFamily: roboto
				borderStyle: pill
			}
		}
	) {
		id
		purchaseUrl
		checkoutStyling {
			backgroundColor
			buttonColor
			fontFamily
			borderStyle
		}
	}
}

Parameters

Field	Type	Description
`backgroundColor`	String	A hex color code (e.g. `#F4F4F5`). `null` to inherit.
`buttonColor`	String	A hex color code (e.g. `#FF5733`). `null` to inherit.
`fontFamily`	enum	`system`, `roboto`, or `open_sans`. `null` to inherit.
`borderStyle`	enum	`rounded`, `pill`, or `rectangular`. `null` to inherit.

Pass null for any field to inherit from the next level in the resolution chain.

Add a known email address

Control the email field on checkout pages using URL parameters. This is useful when you already know a customer’s email from a landing page or customer relationship management system. You can skip collecting the email address again.

Parameter	Effect
`email`	Fills in the email field
`email.disabled=1`	Locks the email field so the customer can’t edit it
`email.hidden=1`	Hides the email field entirely

Examples

Prefill and lock:

https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&email.disabled=1

Prefill and hide:

https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&email.hidden=1

Provide the email parameter to use email.hidden or email.disabled. If you enable both options, checkout hides the field.

When you mount the Checkout element on your own site, pass buyerEmail to prefill the address and lockBuyerEmail to keep the buyer from editing it.

Add a known phone number and address

Fill in the customer’s phone number, billing details, and shipping address with URL parameters. The customer can still edit every prefilled field.

Parameter	Effect
`phone`	Fills in the phone number, including the billing phone for payment methods that need one
`name`	Fills in the billing name
`address.line1`, `address.line2`, `address.city`	Fill in the billing address
`address.state`, `address.postal_code`, `address.country`	Fill in the billing address
`shipping.name`	Fills in the shipping recipient’s name
`shipping.address.line1`, `shipping.address.city`, …	Fill in the shipping address, with the same fields as the billing address

Include the country code in phone and encode the plus sign as %2B, for example phone=%2B14155552671. Use a two-letter country code for country, such as US.

Example

https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&phone=%2B14155552671&name=Ada+Lovelace&address.country=US&address.postal_code=94107

Customer emails

Whop emails your customers about their purchases and subscriptions. The sender name is your business name followed by via Whop, for example Acme via Whop. The sender address is no-reply@businesses.whop.com. If you’ve added a business logo, it appears at the top of each email. Connected accounts that a platform creates through the API start with customer emails turned off. The platform can turn them on with the send_customer_emails field.

Email	When Whop sends it
Order confirmation	After a one-time purchase or the first payment on a membership. Free purchases and later subscription payments don’t get one, and neither does the first charge after a free trial.
Upcoming renewal	About 24 hours before a subscription renews, including when a free trial is about to convert to paid. Whop skips it if the member has canceled or you paused their payments.
Payment failed	When a subscription payment fails and Whop will retry it. Whop doesn’t send it for the final failed attempt that cancels the membership. Some payment methods, such as PayPal, don’t get this email.
Membership canceled	When you or the member cancels a membership, even if access continues until the end of the billing period.
Refund	When you refund a payment.

Whop doesn’t send a separate welcome email or a trial-ending email. To welcome new members by email, set up a User joins message and check Send email to user when triggered.

Turn off customer emails

Go to Dashboard > Settings > Checkout
Turn off Send transactional emails to your members

When customer emails are off, your customers don’t get order confirmations, renewal reminders, or payment failure notices from Whop.

This stops the emails in this table. Invoice emails and notices about billing schedule changes still go out, and so do your automated messages. You can’t edit the wording of Whop’s emails. To send your own emails, trigger them from webhooks.

Do More with Your Money

Products

Growth and Marketing

Affiliates

Manage Business & Team

Set Up Payment Processing

Manage Payments

Manage Payouts

Try the checkout playground

What you can customize

Global branding

Per-link overrides

Customize individual checkout sessions

Parameters

Add a known email address

Examples

Add a known phone number and address

Example

Customer emails

Turn off customer emails

Try the checkout playground

​What you can customize

​Global branding

​Per-link overrides

​Customize individual checkout sessions

​Parameters

​Add a known email address

​Examples

​Add a known phone number and address

​Example

​Customer emails

​Turn off customer emails

What you can customize

Global branding

Per-link overrides

Customize individual checkout sessions

Parameters

Add a known email address

Examples

Add a known phone number and address

Example

Customer emails

Turn off customer emails