Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Embeddable widgets · Boson Protocol
Skip to content

Embeddable widgets

Three pre-built widgets handle the three most common buyer-side flows. Each is a hosted React app you can embed via <script> + a target element, an <iframe>, or a Zoid cross-origin portal.

WidgetUse whenURL
Commit WidgetBuyer accepts an offer and pays/widgets/commit
Redemption WidgetBuyer redeems, cancels, or disputes a voucher/widgets/redemption
Finance WidgetSeller or buyer manages on-chain funds/widgets/finance

Quick embed

<!-- Loads the widget loader once -->
<script src="https://widgets.bosonprotocol.io/scripts/boson-widgets.js" async></script>
 
<!-- Place a commit button anywhere -->
<button
  id="boson-commit"
  data-config-id="production-137-0"
  data-seller-id="2"
  data-product-uuid="…">
  Buy now
</button>

For full options, see Widgets → Embedding methods and Widgets → Configuration.

Hosted at

https://widgets.bosonprotocol.io/ — the canonical deployment.

Versioning

Widgets are continuously deployed from the widgets repo and follow the React Kit version. The script tag always points at the latest stable build; pin a SHA-stamped URL if you need version stability.