Display Actions
Control where your widget appears and how it grabs attention. Hide it on specific pages, show different attention grabbers per page, or auto-open the widget after a delay.
How to get there: Go to Widgets in the left menu → click your widget → Display & Actions tab.
Show Widget
Choose where your widget appears:
- All pages (default) — Widget shows on every page where it's installed
- Specific pages — Widget only shows on pages that match your page rules (see below)
Page Rules
Page rules let you control widget behavior on specific pages. The two most common uses: hiding the widget on checkout, or showing a different attention grabber on your pricing page.
Creating a Page Rule
- Go to the Display & Actions tab
- Scroll to Page-Specific Settings
- Click Add Page Rule
- Enter a URL path (e.g.,
/checkout) - Choose a match type
- Choose an action: Hide or Customize
URL Match Types
| Match Type | Pattern | Matches | Doesn't Match |
|---|---|---|---|
| Exact | /pricing |
/pricing |
/pricing/annual, /new-pricing |
| Starts with | /pricing |
/pricing, /pricing/annual |
/new-pricing |
| Contains | pricing |
/pricing, /new-pricing, /blog/pricing-guide |
/price |
| Ends with | checkout |
/checkout, /eu-checkout |
/checkout/success |
Tip: Use Exact or Starts with for precision. Contains is broad and may match pages you don't intend.
Traffic Source Matching (UTM and Referrer)
Page rules can also match on the visitor's traffic source, so you can show a different widget (or a different CTA) to people coming from Google Ads, a specific newsletter, or a referring site.
In the page rule, expand Optional: only match certain traffic sources to set any of:
- UTM source (e.g.
google,newsletter) - UTM medium (e.g.
cpc,email) - UTM campaign (e.g.
spring-sale) - Referrer contains (e.g.
facebook.com,google.com)
All filled-in fields must match (AND, not OR). Empty fields are ignored. UTM matches are exact; referrer is a "contains" check.
Example: Google Ads spring sale landing
- Path:
/pricing, match type: Starts with - UTM source:
google - UTM medium:
cpc - UTM campaign:
spring-sale - Action: Customize, add a CTA "Welcome from Google! Apply code SPRING20"
Example: Welcome traffic from a specific partner site
- Path:
/(or leave blank to match anywhere) - Referrer contains:
partnerblog.com - Action: Customize, add a CTA "Saw us on Partner Blog? Let's talk."
Actions
- Hide — Completely hides the widget on matching pages
- Customize — Shows the widget but with different attention grabbers (configured per rule)
Common Page Rules
Hide on checkout:
- Path:
/checkout - Match type: Starts with
- Action: Hide
Hide on thank you page:
- Path:
/thank-you - Match type: Exact
- Action: Hide
Sales-focused grabber on pricing:
- Path:
/pricing - Match type: Starts with
- Action: Customize — add a CTA like "Questions about pricing? Let's talk!"
Attention Grabbers
Attention grabbers draw visitors to your widget. Configure them as defaults (all pages) or per page rule.
Trigger Types
Every grabber (CTA, glow, badge, auto-open) supports four trigger types. Pick the one that fits the moment you want to engage.
| Trigger | When it fires | Best for |
|---|---|---|
| Time | After N seconds on the page | Welcome messages, general engagement |
| Scroll | After the visitor scrolls past N% of the page | Engaged readers on long pages, blog posts |
| Exit intent | When a desktop visitor moves their mouse toward the tab/close button | Last-chance offers, recovering abandoning visitors |
| Inactivity | After N seconds of no scrolling or clicking | Polite helper that only triggers if the visitor is stuck |
Exit intent and inactivity are desktop-only. On mobile they fall back to time-based (or you can disable grabbers on mobile entirely).
Call-to-Action (CTA)
A text bubble that appears just above your widget button.
- Message (supports markdown, max 350 characters)
- Trigger type (time / scroll / exit intent / inactivity, see above)
- Auto-close after (seconds, 0 = stays visible). With two bubbles the countdown starts once the second one has appeared, so both stay on screen for the time you set.
- Effect (none, streaming, typing, fade, slide, or pop)
- Show close button
- Only for new visitors
Leave a blank line in the message and Boei shows it as two bubbles stacked on
top of each other, the second one appearing a moment after the first, the way
you would send two short messages instead of one long one. A single line break
stays inside the same bubble.
Glow Effect
A glowing animation around your widget button.
- Trigger type (time / scroll / exit intent / inactivity)
- Duration (how long the glow lasts)
- Intensity (light, medium, strong)
- Color (custom color or your brand color)
Badge (Notification)
A notification count badge on your widget button (like an unread message count).
- Trigger type (time / scroll / exit intent / inactivity)
- Badge count (1-9)
Auto-Open Widget
Automatically opens the widget without the visitor clicking it.
- Trigger type (time / scroll / exit intent / inactivity)
- Only for new visitors
- Skip on internal navigation (don't re-open on every page change within your site)
Mobile Settings
You can disable all attention grabbers on mobile devices — either globally (for default grabbers) or per page rule. This is useful because attention grabbers can feel intrusive on smaller screens.
Widget Interaction Polish
A few recent refinements to how the widget feels in use:
- Quick prompts render cleanly under the chat instead of stacking above the input
- Product cards flow as a horizontal carousel, so multiple items don't push the conversation off-screen
- Popup navigation is preserved on nested-iframe hosts like Google Sites, Notion, and Softr, where a same-tab redirect would otherwise be invisible
- The last user message stays visible in view after sending, so visitors don't lose their place
- Streaming replies no longer auto-chase the scroll position, so users can read earlier text while the answer keeps generating
Tips
- Start simple: hide on checkout and add a CTA on your homepage
- Test your page rules by visiting the pages on your live site
- Use "only for new visitors" to avoid annoying returning visitors
- Combine with Business Hours for time-based behavior
- For swapping entire widgets based on device, country, or language, use Conditions instead