ToolkitSuitePopupShow Only If Display Rules
Features

Show Only If Display Rules

The Show Only If rules give you precise control over who sees a widget and under what conditions. Combine multiple rules with AND/OR logic to build sophisticated targeting.

---

Behavior

Target visitors based on what they are doing right now:

  • Page URL — match the current page URL (contains, equals, starts with, regex).
  • Trackable events — fire a widget when a custom JavaScript event occurs.
  • Time on site — show after the visitor has been on the site for a set number of seconds.
  • URL parameters — target visitors arriving with specific query parameters (e.g., ?utm_source=facebook).
  • Landing page URL — match the first page the visitor landed on during this session.

---

Timing

Control when a widget appears based on date and time:

  • Current date — show a widget only during a specific date range (useful for promotions with deadlines).
  • Recurring dates — target recurring windows (e.g., every weekend, the first week of each month). Timing is based on the visitor's timezone.

---

Traffic Source

Filter by how the visitor arrived:

  • Session referrer — the referring URL that started the current session.
  • Page referrer — the referring URL for the current page.
  • Page URL — the URL of the page being viewed.

---

Visitor History

Target returning visitors based on their past behavior:

  • Viewed pages — number of pages viewed across all sessions.
  • Visit number — how many times the visitor has returned to the site.
  • Time since first visit — days elapsed since the visitor's very first session.
  • Time since last visit — days elapsed since the visitor's most recent previous session.

---

Technology

Filter by device and browser characteristics:

  • Screen width — target specific screen sizes (e.g., show only on screens wider than 1024px).
  • Platform type — desktop, tablet, or mobile.
  • Cookies — check whether a specific cookie exists or matches a value.
  • Person parameters — custom data attributes passed to Popup via JavaScript.

---

Location

Target by geographic location:

  • Country — show a widget only to visitors from specific countries.
  • Region — narrow to a state or province.
  • City — target a specific city.

Location is determined by the visitor's IP address.

---

Widget Management

Coordinate how multiple widgets interact:

  • Other displayed widgets — show or hide a widget based on whether another widget has already been displayed, submitted, or closed during the session.

This prevents widget conflicts and lets you build sequences (e.g., show Widget B only after Widget A has been closed).

---

Third-Party Integration

When an ESP is connected, additional targeting options become available:

  • Tags — target contacts with specific tags in your ESP.
  • Lists — target contacts on a specific list.
  • Custom fields — match against custom field values stored in your ESP.

See Targeting by Tags & Custom Fields for full details.

---

Combining Rules: AND / OR Logic

  • AND — all conditions must be true for the widget to display.
  • OR — any one condition being true is enough.

You can nest AND and OR groups to create complex targeting logic.

Example — AND: Show the widget only when the visitor is on a pricing page AND has visited at least 3 pages AND is on a desktop device.

Example — OR: Show the widget when the visitor arrived from Google OR from Facebook.

Example — Combined: Show the widget when (the visitor is from the US AND on mobile) OR (the visitor has the tag "VIP" in your ESP).

---

Need more help?

If you've worked through this and still need a hand, contact support — we'll dig in with you.