> For the complete documentation index, see [llms.txt](https://coindisco.gitbook.io/coindisco/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coindisco.gitbook.io/coindisco/widget-integration/quickstart.md).

# Widget quickstart

## 1. Create or open a widget

Open [Dashboard - Widgets](https://dashboard.coindisco.com/widgets) in the required environment.

## 2. Configure the allowed origin

Add the exact website origin that will embed the widget, including the scheme and port when applicable.

```
https://app.example.com
http://localhost:3000
```

Do not add a path such as `/checkout`; origins contain only scheme, host, and optional port.

## 3. Copy the widget URL

The URL contains the correct sandbox or production public key.

```
https://widget.coindisco.com/?publicKey=pk_test_YOUR_PUBLIC_KEY
```

## 4. Open or embed the URL

Use a redirect for the smallest integration or an iframe to keep the flow on the current page.

## 5. Test the complete flow

Test region and method selection, buy or sell quotes, wallet validation, provider redirect, and transaction updates. Then verify responsive iframe behavior and failure states.