Skip to content

Add and manage website widgets and popups (On-Site Displays)

On-Site Displays, On-site Displays, webext, website widget, chat widget, WhatsApp widget, rewards widget, popup, install widget, app embed, Studio

On-Site Displays is where you add BusinessOnBot widgets to your website, check they’re working, and change how they look. To open it, click On-site Displays in the left menu.

It has two tabs:

  • Widgets: the WhatsApp, chat and rewards widgets on your site.
  • Popup: the popup that collects visitors’ phone numbers and emails.

On-Site Displays → Widgets, with a live chat widget card

Each widget card shows:

  • Shown on: your website platform (Shopify, WooCommerce or Custom site) and how the widget is installed (app embed, script or manual).
  • Status: for example Live, Install required, Config required, Not recently active (not seen on your site for 24 hours) or Needs attention. Widgets that need you appear first.
  • Installed correctly, Last seen (when the widget was last detected on your site) and the published version.
  1. Click New widget.

  2. Choose the widget:

    • WhatsApp Widget: lets customers message you on WhatsApp.
    • Rewards Widget: shows rewards and referral offers on your site.
    • Chat Widget: a real-time chat window on your website.

    You can have one of each.

  3. Choose where your website is hosted: Shopify, WooCommerce or Custom website. Shopify and WooCommerce are available when your store is connected.

  4. Enter a Widget name so you can recognise it. For WhatsApp and Rewards widgets, pick the WhatsApp account that will receive the messages.

  5. Check the summary and click Create widget.

Then finish the installation:

  • Shopify (recommended: app embed). If the app embed isn’t on yet, you’ll see Enable Shopify app embed. Click Open Shopify theme editor, turn on the BusinessOnBot app embed, then click I’ve enabled it, check again. You can choose Use script tag instead if you prefer.
  • Custom website. Click Copy script and paste it into your site just before the closing </body> tag. Or click Send to developer to email it. Then click I’ve installed the script, check now.

You can close the window and continue later. The card shows Continue setup until it’s done.

Click Check installation on the widget card. You’ll see one of:

  • Installation successful: the widget is live.
  • Installation not detected: the script isn’t on your site yet. Add it before </body> and click Check again.
  • Setup failed: click Retry setup. If it still fails, click Check connection to email our support team.

Click Customize on the card. This opens Studio, with a live preview (switch between desktop and mobile at the top).

Setting What you can change
Colors Primary colour, text colours and background
Placement Bottom left or bottom right, and the gap from the side and bottom, separately for desktop and mobile
Visibility Show on desktop, mobile or both, and on all pages or only specific pages (page rules: equals, not equals, matches)
Custom Css Your own CSS, for advanced styling

Each widget type has its own settings too. For example, the WhatsApp widget’s store name, message and tooltip; the chat widget’s greeting callout, FAQs, contact options and logo; and the rewards widget’s earn, redeem and referral options.

Click Save as Draft to keep your changes without showing them, or Publish to update the widget on your website.

Click ⋮ on a card to:

  • Get script / SDK: copy the widget’s script, or open the JavaScript SDK docs.
  • Deactivate: stop the widget showing on your site.

On-Site Displays → Popup, with popup analytics and the two-step popup preview

The popup asks visitors for their phone number or email (step 1), then shows them a coupon code or thank-you message (step 2).

Popup Analytics shows, for the date range you pick:

Metric What it counts
Total displays How many times the popup was shown
Phone numbers Phone numbers collected
Emails Emails collected
Submission rate New form submissions ÷ views × 100

Click Download Contacts to download the phone numbers and emails collected in that range.

  1. Click Edit popup.

  2. Choose the Popup type: Coupon code popup or Subscriber/Waitlist.

  3. Set your Brand primary color, the Audience (all visitors, or only new visitors) and Display popup after (how many minutes and seconds after the visitor arrives).

  4. On Edit step 1, choose an image layout and upload an image (JPEG or PNG, up to 5 MB, 16:9 suggested). Write the heading (up to 20 characters) and description (up to 120), and choose what to collect: phone number, email or both.

  5. On Edit step 2, write what visitors see after they submit. For a coupon popup, add the Coupon Code (up to 15 characters).

  6. Click Preview to check it, then Save and Publish.

  7. Turn on Enable Popup.

Was this page helpful?

Still stuck? Email support@businessonbot.com