Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.moonpay.com/llms.txt

Use this file to discover all available pages before exploring further.

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).
Theming

Implementing your theme

To apply your custom theme, simply set your newly created theme to the default and save the changes. This will ensure that the widget or transaction tracker is initialized with the corresponding theme whenever you use your MoonPay API key.

Examples

Mobile
Desktop

Available personalizations

  • Brand logos. Please contact your MoonPay team and include:
    • 1 rectangular logo for transactional emails
  • Color choices accommodating both light and dark preferences.
    • Widget Background Color
    • Primary Button Color
  • Custom Loader - for a simple approach to customizing the loader that your MoonPay widget displays, you can use the dashboard:
    1. Go to the B2B dashboard
    2. Navigate to “Theme” → “Loader”
    3. Choose your preferred loader type (MoonPay default or generic spinner)
    4. Select custom colors to match your brand
    5. Save changes

Usage of theme

You can manually choose light or dark modes using thetheme widget parameter. e.g. theme=dark or theme=light