> For the complete documentation index, see [llms.txt](/llms.txt).

# Customization

## Branding[​](#branding "Direct link to Branding")

The **Branding** page lets you personalize the visual identity of your dapp across login screens, MFA screens, the wallet UI, and login modals.

note

Changes can be previewed in real time. Click **Save & Publish** to apply them to production.

![Customization branding](/assets/images/customization-branding-813212eb6655a8229b28f01ce0b64b93.png) 

### Branding options[​](#branding-options "Direct link to Branding options")

#### Add brand logo[​](#add-brand-logo "Direct link to Add brand logo")

Upload a logo (.png recommended) to personalize the login flow, wallet views, and system emails.

#### Use logo as loader[​](#use-logo-as-loader "Direct link to Use logo as loader")

When enabled, your uploaded logo replaces the default loading spinner in the Embedded Wallets login flow.

#### Custom terms and conditions / privacy policy[​](#custom-terms-and-conditions--privacy-policy "Direct link to Custom terms and conditions / privacy policy")

Link to your terms of service and privacy policy. These links appear during user onboarding and consent flows.

#### Application name[​](#application-name "Direct link to Application name")

The name used in system-generated emails, including email subject lines.

#### Default language[​](#default-language "Direct link to Default language")

Set the default language for all user-facing Embedded Wallets components. Supported languages:

- English, Japanese, Korean, German, Mandarin, Spanish, French, Portuguese, Dutch, Turkish

### Theme and colors[​](#theme-and-colors "Direct link to Theme and colors")

#### Select mode[​](#select-mode "Direct link to Select mode")

Choose **Light**, **Dark**, or **Auto**. Auto adapts to the user's system theme.

#### Primary color[​](#primary-color "Direct link to Primary color")

The primary brand color applied to buttons, links, tab indicators, focus outlines, loaders, and navigation tabs.

#### On primary color[​](#on-primary-color "Direct link to On primary color")

The color for text and icons that appear on top of primary-color backgrounds (for example, button labels). Choose a combination that meets [WCAG contrast guidelines](https://www.w3.org/WAI/standards-guidelines/wcag/).

## Login modal[​](#login-modal "Direct link to Login modal")

The **Login Modal** page controls the appearance and behavior of the authentication flow.

![Customization login modal](/assets/images/customization-login-modal-c6c96b2cef4e1e280b45a8c9a3cb4f2c.png) 

### Design[​](#design "Direct link to Design")

#### Login modal appearance[​](#login-modal-appearance "Direct link to Login modal appearance")

Choose how the login UI is displayed:

- **Embedded widget**: the login UI is embedded in your dapp's layout.
- **Modal widget**: the login UI opens as a pop-up overlay.

#### Logo alignment[​](#logo-alignment "Direct link to Logo alignment")

- **Center-aligned**: logo appears at the top center.
- **Left-aligned**: logo appears at the top left.

#### Border radius[​](#border-radius "Direct link to Border radius")

Adjust the corner curvature of the modal: small, medium, or large.

#### Border radius type[​](#border-radius-type "Direct link to Border radius type")

Set the shape of buttons and input fields:

- **Pill**: fully rounded ends.
- **Rounded**: gently curved corners.
- **Square**: sharp 90-degree corners.

### Authentication reorder[​](#authentication-reorder "Direct link to Authentication reorder")

Drag and drop login methods to set the order in which they appear to users. Prioritize the method most of your users are likely to choose.

### External wallets[​](#external-wallets "Direct link to External wallets")

#### Show installed external wallets[​](#show-installed-external-wallets "Direct link to Show installed external wallets")

When enabled, the login modal detects and displays compatible wallets already installed in the user's browser or device, such as MetaMask.

#### Select number of external wallets[​](#select-number-of-external-wallets "Direct link to Select number of external wallets")

Set how many external wallet options are shown at once.