> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onstacks.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure your widget

> Branding, payment options and permitted websites, under Settings → Ramps → Website widget.

Sandbox and Live each have their own widget. The environment switch in the dashboard sidebar chooses which one you're editing. Saving a change asks for the code we email you.

The top of the section shows the widget's state: **Not configured**, **New links enabled** or **Paused**.

## Website

| Setting | What it does |
| - | - |
| **Websites allowed to embed your widget** | The pages that may open the widget, up to 10. `https` addresses only; `http://localhost` is also allowed in Sandbox. A page that isn't listed gets a not-found screen instead of the widget. |
| **Redirect origins** | Where a widget link's `redirect` may send the customer. By default the same as the websites above. Turn on **Use different redirect origins** when customers should land somewhere else. |

Redirect origins matter only when a customer opens a widget link as a full page, for example from an email. Inside the window on your page the widget doesn't navigate; your callbacks run instead.

**Example.** The widget opens on `https://shop.example.com`, but after paying you want the customer on `https://account.example.com/orders/123`. Turn on **Use different redirect origins**, add `https://account.example.com`, and pass `redirect: "https://account.example.com/orders/123"` in the link.

## Appearance

| Setting | What it does |
| - | - |
| **Display name** | The business name shown at the top of the widget. |
| **Button colour** | The colour of the widget's buttons. |
| **Logo address** | An `https` URL of your logo. |
| **Support chat** | Whether customers can open support chat inside the widget. |

## Payment options

| Setting | What it does |
| - | - |
| **Buy and sell stablecoins**, **Buy stablecoins only**, **Sell stablecoins only** | Which directions the widget offers. A link that asks for a direction you turned off is refused. |
| **Stablecoins**, **Networks**, **Currencies** | All supported, or only the ones you pick. Prefills in a link are limited to these; the customer can choose among them. |

The exact assets, networks and currencies you can enable are listed under [Coverage](/ramps/reference/coverage).

## Signing secret & security

| Setting | What it does |
| - | - |
| **Signing secret** | Shown once when the widget is created. Only needed for [signed links](/ramps/widget/signed-links). **Rotate secret** invalidates every link signed with the old one. |
| **Allow unsigned links** | On by default: your page opens the widget with the widget ID alone, and link parameters are prefills the customer can change. Turn it off to require every link to be signed. |
| **Accept new widget links** | Turn it off to pause the widget: new opens show a not-found screen, and payments already in progress continue. The state at the top reads **Paused**. |

The widget ID is permanent and appears in every link as `/w/<widget-id>`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.