Customizing theme using query parameters

Customize the look and feel of the OZZOBiT widget

The OZZOBiT widget can be customized to match your brand's look and feel. Use query parameters to control colors, logos, and display options so the widget feels like a natural part of your application.

Theme Parameters

Parameter	Type	Default	Description
themeColor	string	#1461db	Primary accent color for buttons, links, and highlights
hostLogoURL	string		URL of your logo displayed in the widget header
hostURL	string		Your website URL shown in footer
hostURLName	string		Display name for your host URL in footer
screenBackgroundColor	string	#ffffff	Background color of the entire widget
exchangeScreenTitle	string		Custom title for the main exchange screen
hideMenu	boolean		Hide the menu button in the header
hideMenuBar	boolean		Hide the entire menu bar / header area

Color Mode Options

texttext

https://OZZOBiT.com/global?apiKey=YOUR_KEY&themeColor=%231461db&screenBackgroundColor=%23ffffff

Light mode is the default theme with a white background and dark text.

texttext

https://OZZOBiT.com/global?apiKey=YOUR_KEY&themeColor=%236366f1&screenBackgroundColor=%230f1117

Set a dark background color for a dark mode appearance. Combine with a lighter or vibrant themeColor for best results.

texttext

https://OZZOBiT.com/global?
  apiKey=YOUR_KEY
  &themeColor=%236366f1
  &hostLogoURL=https%3A%2F%2Fyour-app.com%2Flogo.png
  &hostURL=https%3A%2F%2Fyour-app.com
  &hostURLName=YourApp
  &exchangeScreenTitle=Buy Crypto on YourApp
  &hideMenu=false

Examples

ℹ️

Minimal Widget

texttext

<!-- Clean, minimal look -->
https://OZZOBiT.com/global?
  apiKey=YOUR_KEY
  &themeColor=%23000
  &hideMenuBar=true
  &exchangeScreenTitle=Purchase

ℹ️

Full Branding

texttext

<!-- Fully branded with your logo and colors -->
https://OZZOBiT.com/global?
  apiKey=YOUR_KEY
  &themeColor=%237c3aed
  &hostLogoURL=https%3A%2F%2Fyour-brand.com%2Flogo-dark.png
  &hostURL=https%3A%2F%2Fyour-brand.com
  &hostURLName=YourBrand
  &exchangeScreenTitle=Buy Crypto
  &defaultCryptoCurrency=ETH
  &network=ethereum

ℹ️

NFT Checkout Theme

texttext

<!-- NFT Checkout with custom branding -->
https://OZZOBiT.com/global?
  apiKey=YOUR_KEY
  &productsAvailed=NFT
  &themeColor=%23ec4899
  &hostLogoURL=https%3A%2F%2Fnft-marketplace.com%2Flogo.png
  &exchangeScreenTitle=Complete Your Purchase
  &nftContractAddress=0x...
  &nftTokenId=1234
  &nftNetwork=polygon

Best Practices

Logo size: Use a PNG logo at 200x40px for optimal display in the header
Contrast: Ensure your themeColor has sufficient contrast against white backgrounds (WCAG AA minimum)
Consistency: Match your themeColor to your app's primary brand color
Testing: Always test your themed widget across different screen sizes and devices
URL encoding: Remember to URL-encode special characters in parameter values (# → %23, etc.)