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

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.