BillyDocumentation

Embed Widget on WordPress

Add the Billy checkout to a WordPress site with a Custom HTML block, on a page or in a pop-up.

Got a website built with WordPress? Great news, adding your Billy checkout to it is quick and easy!

Billy's widget lets your fans buy tickets directly on your site, no redirects, no confusion, no tech headaches.

You can choose between two simple options

Option 1: Embedded Checkout

The Billy checkout appears directly inside your event page, so fans can browse and buy tickets in one place.

The Billy checkout embedded inside an event page

Option 2: Pop-up window

The Billy checkout opens in a clean pop-up window when visitors click your "Buy Now" button, perfect for keeping your page layout simple.

The Billy checkout opened in a pop-up window over a website page

No matter which option you choose, fans can complete their purchase without leaving your website.

That means:

  • A smoother checkout experience
  • Higher conversion rates
  • A stronger, more professional brand image

Ready to set it up? Let's go, it only takes a few minutes.

Before starting…

Where to Find Your Sales Channel ID

Publish your Sales Channel first

Important: You will NOT see a Sales Channel ID until your Sales Channel is published. If it's still in draft, the link and ID won't exist yet.

Open your Sales Channels

  • Go to Studio → Event → Sales Channels
  • Select the channel you want to use
  • Scroll down to the bottom and click the Share button
The Share button at the bottom of a sales channel page in the Billy studio

Extract your Sales Channel ID

  • The Sales Channel ID is simply the long code at the end of the URL.
  • Example URL: https://events.billyapp.live/12b8b09a-eb23-4d65-ba92-f6059cb18648 → Here, 12b8b09a-eb23-4d65-ba92-f6059cb18648 is your Sales Channel ID.
The share dialog showing the sales channel URL ending with the sales channel ID

Before embedding the widget

Please make sure:

  • You are on a WordPress Business or Commerce plan (to use Custom HTML)
  • You have activated your WordPress Business or Commerce plan

Here's a how-to: Activate Your Business Plan

Option 1: Embedding your checkout flow on a page

You can insert Billy's checkout widget directly on your website. Your attendees will be able to purchase tickets or products without being redirected to third parties. A smooth ticketing experience worth remembering.

In 3 simple steps we can make it happen — let's see how below.

Animation showing the Billy widget embedded on a WordPress page

To start, please be sure to have at least two pages of your website ready-to-go:

  • A home page with a button visitors can click on
  • Another page containing Billy's widget, where visitors will be redirected once they've clicked on the CTA.
  1. Choose the button on your homepage which your visitors can click to start checkout
  2. Add the URL of the other page, where you will display the checkout widget, to this button
A WordPress page with the Buy Now button selected The WordPress link field where the widget page URL is entered

Step 2. Add an HTML block on the widget display page

  1. Navigate to the left sidebar on the specific page which will display the widget
  2. Add a Custom HTML block. You can change the position of the widget by dragging the block up or down in the panel
The WordPress block inserter with the Custom HTML block

Tip: If it shows that the block can't be inserted, it might be because you forgot to click inside the page where you want to put the widget.

The WordPress editor with the block inserter disabled

For example, click Type / to choose a block and you can insert a block.

The WordPress editor showing the Type slash to choose a block prompt

Step 3. Copy and paste the widget code

  1. Click Write HTML… on the interface
  2. One step closer — copy and paste the following code into the editor
<iframe src="[EVENT URL]" allow="payment" width="100%" height="1000px"></iframe>

Please be sure to replace [EVENT URL] with your event widget unique URL. You can find this information in the Billy studio, on your event's distribution channel page. Your event URL should look like https://events.billyapp.live/fr/3f532137-dae9-4f16-870b-f3739dfa761a.

  1. Click the Save button, and voilà!
Animation of the finished on-page widget integration in WordPress

You now have your checkout flow well integrated into your event website, congratulations! You can now publish this updated version and test the user experience.

Option 2: Using a pop-up to display your checkout flow

You can also use a pop-up window to display your checkout flow on a single page. Following the 2 steps below, you can easily make it happen.

Animation showing the Billy checkout opening in a pop-up on a WordPress site

To start, please be sure to have a page with at least one CTA (call to action) visitors can click. Afterwards, on click, a pop-up window will appear in the same page, instead of redirecting to another page.

Step 1. Copy and paste the mandatory script

  1. Navigate to the left sidebar
  2. Again, add a Custom HTML block into the content in your current page
  3. Copy and paste the following code
<script type="text/javascript"
        defer src="https://events.billyapp.live/embed.js"
        data-host="https://events.billyapp.live"></script>
  1. Click the Save button in the upper right corner

Tip: The pop-up way does not require a new page. Only one Custom HTML block is needed on the home page.

Step 2. Add customized attributes code

  1. Choose the button on the home page which you want to link to the widget
  2. Click the and choose Edit as HTML
  3. One step closer — copy and paste the following code
<div class="wp-block-button">
<a
class="wp-block-button__link wp-element-button"
role="button"
aria-haspopup="dialog"
aria-controls="[YOUR_SALES_CHANNEL_ID]"
aria-expanded="false">
BUY NOW
</a>
</div>


<div class="wp-block-button popmake-234">
<a
class="wp-block-button__link has-accent-5-background-color has-text-color has-background has-link-color wp-element-button"
role="button"

style="color:#0d0d0d"
aria-haspopup="dialog"
aria-controls="c0f35f0d-e408-4a38-a4ba-7c563dc0f995"
aria-expanded="false">
Réserver→
</a>
</div>
  1. The variable [YOUR_SALES_CHANNEL_ID] needs to be replaced by the unique ID of your widget. You can find this information in the Billy studio, on your event's distribution channel page. Your sales channel ID should look like c0f35f0d-e408-4a38-a4ba-7c563dc0f995, which is the end part of the URL.
  2. Be aware of all the blanks after you copy and paste the code.
  1. Click the Save button in the upper right corner

You now have your checkout flow pop-up integrated into your event website, congratulations! Now preview your website, and Billy's widget will pop up on your page.

On this page