| title | Customization |
|---|---|
| sidebar_label | Customization |
| image | img/metamaskog.jpg |
| description | Customize branding and login flow in MetaMask Developer Dashboard | Embedded Wallets |
import CustomizationBranding from '@site/static/img/embedded-wallets/dev-dashboard/customization-branding.png' import CustomizationLoginModal from '@site/static/img/embedded-wallets/dev-dashboard/customization-login-modal.png'
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.
:::
Upload a logo (.png recommended) to personalize the login flow, wallet views, and system emails.
When enabled, your uploaded logo replaces the default loading spinner in the Embedded Wallets login flow.
Link to your terms of service and privacy policy. These links appear during user onboarding and consent flows.
The name used in system-generated emails, including email subject lines.
Set the default language for all user-facing Embedded Wallets components. Supported languages:
- English, Japanese, Korean, German, Mandarin, Spanish, French, Portuguese, Dutch, Turkish
Choose Light, Dark, or Auto. Auto adapts to the user's system theme.
The primary brand color applied to buttons, links, tab indicators, focus outlines, loaders, and navigation tabs.
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.
The Login Modal page controls the appearance and behavior of the authentication flow.
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.
- Center-aligned: logo appears at the top center.
- Left-aligned: logo appears at the top left.
Adjust the corner curvature of the modal: small, medium, or large.
Set the shape of buttons and input fields:
- Pill: fully rounded ends.
- Rounded: gently curved corners.
- Square: sharp 90-degree corners.
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.
When enabled, the login modal detects and displays compatible wallets already installed in the user's browser or device, such as MetaMask.
Set how many external wallet options are shown at once.