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

Sell via WooCommerce

The Boson for WooCommerce plugin lets a WordPress / WooCommerce store sell physical products as NFTs. Your existing storefront stays as-is; the plugin adds a redemption page where buyers redeem their rNFTs (and raise disputes), and it syncs Boson orders with your normal WooCommerce order management.

You don't need to do any blockchain transactions or pay gas — the plugin's role is to manage rNFT redemptions, disputes, and delivery info; product listing happens on the Boson dApp.

How it works

1. Create a seller account + offers on the Boson dApp     (see Sellers / Sell via the Boson dApp)
2. Install the plugin & connect your Boson seller account
3. Design and customise your redemption page
4. Manage orders & fulfilment like any other WooCommerce product

Requirements

  • Store running PHP ≥ 7.3, WordPress ≥ 6.0, WooCommerce ≥ 7.4.
  • The GMP PHP Extension (your host may already have it).
  • An SSL certificate.
  • A Web3 client your buyers can connect with — MetaMask or WalletConnect.

Install

  1. Find Boson for WooCommerce on the WooCommerce Marketplace and download the .zip.
  2. In WordPress admin: Plugins → Add New → Upload Plugin, select the .zip, click Install Now.
  3. Activate the plugin.

Updating works the same way — WordPress will ask to replace the existing version.

Connect your seller account

  1. WooCommerce → Boson for WooCommerce.
  2. Connect Account (if you already have a Boson seller profile) or Create Account (jumps to the dApp).
  3. Pick a Web3 client and connect your wallet.
  4. Confirm the connected wallet address. The plugin checks on-chain that this address has a Boson seller account.
  5. Click Proceed and sign the message in your wallet. This message signs the origin URL of your WooCommerce site — the Redemption Widget will only render on that domain, protecting buyers from impersonation.

Once your wallet is identified as a registered Boson seller, the plugin is ready.

If you later change the seller's wallet on the Boson side, log out of WooCommerce and log back in to re-connect. Existing product/exchange links survive.

Build a redemption page

The plugin offers two ways to embed the Redemption Widget on a page:

Blocks (Gutenberg-native):
  • Boson Button Widget — a button you can style; opens the redemption flow in a modal.
  • Boson Widget — embeds the widget directly on the page.

Shortcodes (fallback for themes that don't support blocks):

[boson_button text="Redeem"]
[boson_widget]

If you click Create Redemption Page the plugin creates a basic page with the widget for you. Customise it further from the WordPress page editor; it appears under Pages in the WordPress admin.

Shipping method

Choose a single shipping method that the plugin will attach to every Boson order. Whatever cost is registered against that shipping method, the plugin forces it to 0 on Boson orders (since shipping is handled out-of-band by you and the buyer). Third-party shipping integrations can read the registered method off each order.

Data synchronisation

After connection, the plugin syncs offers, redemptions, and disputes between Boson Protocol and WooCommerce.

  • Auto-sync runs every 30 minutes.
  • Manual sync is available on demand from the plugin admin.

If a buyer redeems an rNFT outside WooCommerce (e.g. directly on the Boson dApp), the order appears in WooCommerce with a warning. Manage that order via the dApp — delivery info and any buyer-seller messaging happened there.

Limitations

  • One Boson seller per WordPress site — use multi-site if you need separate Boson identities.
  • No on-chain transactions from the plugin — listings are still created on the Boson dApp; the plugin handles fulfilment-side ops.
  • Variations map to separate Boson offers under a shared productUuid.

Where to go next