Display Conditions

Control which widget displays based on page URL, language, or other criteria. Show different widgets on different pages or hide widgets entirely.

How to get there: Go to Setup → Widget in the top menu → click your widget → scroll to the Conditions section.

How Conditions Work

Conditions let you:

  • Hide widgets on specific pages (like checkout)
  • Show different widgets for different languages
  • Display targeted widgets based on URL patterns

Creating a Condition

  1. Go to your widget list
  2. Click New Condition
  3. Name your condition (not visible to customers)
  4. Click Edit to configure

Create condition

Condition Settings

If Rule

The rule that checks the condition:

Page-based rules:

  • Page URL contains - Matches when URL includes specific text
  • Page URL does not contain - Matches when URL doesn't include specific text
  • Page URL is exactly - Exact URL match
  • Page URL is exactly not - Doesn't match exact URL

Device-based rules:

  • Visitor is on mobile - Matches mobile devices
  • Visitor is not on mobile - Matches desktop devices

Location-based rules:

  • Visitor country is - Matches specific country
  • Visitor country is not - Excludes specific country

Has Value

The text to search for in the URL.

Then Display Widget

Which widget to show (or none to hide).

Common Use Cases

Hide on Checkout Page

Don't distract customers during checkout:

  1. Create a condition named "Hide on checkout"
  2. Set rule: Page URL contains
  3. Set value: /checkout
  4. Set widget: None

Hide on checkout

This hides the widget on:

  • yoursite.com/checkout
  • yoursite.com/checkout/payment

Multi-Language Widgets

Show translated widgets based on URL:

  1. Create widgets for each language (English, Dutch, etc.)
  2. Set English as default
  3. Create conditions for other languages:

For Dutch:

  • Rule: Page URL contains
  • Value: /nl/
  • Widget: Dutch widget

Multi-language setup

  1. Repeat for other languages

All language conditions

Page-Specific Widgets

Show different channels on different pages:

  • Sales widget on pricing page
  • Support widget on help pages
  • General widget elsewhere

Country-Specific Widgets

Display different widgets based on where your visitors are located:

Example: Show local support per country

  1. Create widgets for each country (Dutch support, German support, etc.)
  2. Set your main widget as default
  3. Create country conditions:

For Netherlands:

  • Rule: Visitor country is
  • Country: Netherlands
  • Widget: Dutch support widget

For Germany:

  • Rule: Visitor country is
  • Country: Germany
  • Widget: German support widget

Why use this:

  • Show local phone numbers and support teams
  • Display region-specific offers
  • Present content in the visitor's language
  • Hide features not available in certain regions

Default Widget

The default widget loads when:

  • No conditions are set
  • No conditions match the current page

Default widget

How Country Detection Works

Boei automatically detects your visitor's country based on their location. This works instantly and respects privacy - we only detect the country, not the exact location.

Tips

  • Use URL patterns that won't accidentally match other pages
  • Test conditions on different pages
  • Set a sensible default widget
  • Conditions are evaluated in order - first match wins