πŸ› οΈ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.

Parameter
Type
Description

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.

Parameter
Type
Description

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.

Parameter
Type
Description

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