π οΈWidget Configuration Parameters
You may use these parameters in your URL to further customize your Widget
Environment:
These are the minimum configuration values required to embed and initialize the widget.
Tip: These values help Coindisco render the correct version of your widget for the right audience and context.
widgetUrl
string
Main widget base URL. Used in iframe src
.
customizeUrl
string
Link to customization builder. Optional.
publicKey
string
Identifier for your widget instance - your personal key you get from Coindisco
allowedNetworks
string
Comma-separated list of blockchain networks (e.g., ethereum,solana,bsc
).
Transaction Defaults:
Use these parameters to pre-fill what the user will see when the widget loads β like currency, crypto, network, amount, and wallet address.
Tip: Use lockDefaultAsset for campaigns or integrations where only one token should be offered.
defaultFiat
string
Fiat currency to show by default (e.g., USD
, BRL
).
defaultFiatAmount
number
Amount in fiat to pre-fill (e.g., 100
).
defaultAsset
string
Token to purchase by default (e.g., aqua
, eth
). Must match Disco API.
walletAddress
string
Crypto wallet address where funds will be sent.
defaultNetwork
string
Blockchain network (e.g., ethereum
, stellar
). Must match supported networks.
lockDefaultAsset
boolean
If set to true
, users cannot change the selected crypto asset.
Theme & Style:
Make the widget match your brand using a wide range of visual customization options. All colors are passed as HEX codes (e.g. #1a1a1a or #ffffff).
Tip: These parameters give you pixel-level control over how the widget blends into your UI.
theme
string
Choose between light
, dark
, or leave empty to follow user device.
backgroundColor
string
General background of the widget.
backgroundCard
string
Background of the card elements inside the widget.
borderColor
string
Border color of elements.
buttonBackground
string
Background color for primary buttons.
errorColor
string
Color used for error messages or states.
successColor
string
Color used for success states (e.g., after transaction).
hoverColor
string
Hover/focus color for buttons and inputs.
invertTextColor
string
Color used on dark backgrounds.
secondTextColor
string
Secondary text color (less emphasis).
skeletonGradientFrom
string
Start color for loading animation gradients.
skeletonGradientTo
string
End color for loading animation gradients.
textColor
string
Main text color.
iconsColor
string
Color of icons used in the widget.
Last updated