> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Branding Settings

> Upload your merchant logo and set brand colors in the StablePay Portal to apply branding across StablePay-hosted customer surfaces.

Branding Settings lets merchants configure core brand elements once in the StablePay Portal and apply them across StablePay-hosted customer-facing surfaces.

This feature is useful when you want customers to more clearly recognize your business while paying, viewing invoices, or receiving related communications. It helps create a more consistent and trusted experience without requiring merchants to rebuild hosted payment surfaces themselves.

## What you can configure

Merchants can currently configure:

* `Logo`: your full brand logo
* `Background`: the main branded background color
* `Button`: the primary button and CTA color

Changes first appear in preview and only go live after the merchant clicks `Save changes`.

## Where branding appears

Branding Settings applies to StablePay-hosted customer-facing surfaces, including:

* Stablecoin Checkout
* Payment Links pay page
* Subscription checkout
* Hosted Invoice Payment Page
* Invoice PDF
* customer-facing related email touchpoints

If your business uses multiple StablePay products, this helps keep checkout, billing, and communication surfaces visually aligned.

## How to use it

1. Open `Settings` in the StablePay Portal
2. Go to `Branding`
3. Upload your merchant logo
4. Set the background and button colors
5. Review the Desktop / Mobile or Invoice preview
6. Click `Save changes` to publish the update

## Defaults and fallback behavior

* If no logo is uploaded, StablePay uses the default placeholder behavior
* If no background color is set, StablePay falls back to the default background color `#635BFF`
* If no button color is set, StablePay falls back to the default button color `#2452F8`
* If branding assets fail to load, hosted surfaces fall back to the default style instead of blocking the page

## Upload and setup guidance

* Use a clear PNG or JPG for the logo
* A minimum size of `128 × 128 px` is recommended
* Keep the file size within `512 KB` where possible
* Choose background and button colors that match your brand while preserving button and content readability

## When to set it up

Branding Settings is best configured before going live, especially when:

* you want Hosted Checkout to feel more like your own branded payment page
* you send invoices, invoice PDFs, or payment links to customers
* you want consistent branding across hosted pages and customer emails

## Important notes

* This release focuses on core brand elements, not a full theme system
* It does not currently support custom fonts, layouts, border radius, copy, or page-level overrides
* Branding Settings is configured in the Portal and does not require API integration

## Related pages

* [Get Started](/en/product/Get-Started)
* [Stablecoin Checkout](/en/product/Stablecoin-Checkout)
* [Payment Links](/en/product/Payment-Links)
* [Invoicing](/en/product/Invoicing)
* [Checkout Display & Logo Guidelines](/en/product/Checkout-Display-Guide--StablePay-Logo)