Customize the widget's appearance
Enhance your website or applications user experience by tailoring the MoonPay widget's appearance to align with your brand. These personalization options are referred to as a theme.
Building your theme
Your website or application can feature a unique theme that includes a dedicated theme.
You can build your theme using MoonPay dashboard theme builder. Themes built on the MoonPay dashboard are tied to your API key and will show up wherever you use your API key (e.g. widget, transaction tracker).

Implementing your theme
To apply your custom theme, simply set your newly created theme to Active
on the theme creation screen.
This will ensure that the widget or transaction tracker is initialized with the corresponding theme whenever you use your MoonPay API key.
Examples



Available personalizations
- Brand logos. Please contact your MoonPay team and include:
- 1 square logo for the widget login screen
- 1 rectangular logo for transactional emails
- Color choices accommodating both light and dark preferences.
- Button corner radius for a tailored look.
- Foreground element corner radius customization for:
- Icons
- Display boards
- Text input fields
Usage of themeId
themeId
Most partners will not use the themeId
widget parameter. It was introduced before the self-service theme builder was launched and is only used by partners who had themes built for them prior.
Updated 11 months ago