Triggers

Triggers control when Beacon automatically opens the panel without user interaction. Use them to proactively engage visitors at the right moment.

Auto-Open

Configure Beacon to open automatically based on timing, page path, or exit intent.


{
  "triggers": {
    "autoOpen": {
      "enabled": true,
      "delayMs": 15000,
      "paths": ["/pricing", "/checkout"],
      "exitIntent": true
    }
  }
}

Properties

Property	Type	Default	Description
`enabled`	boolean	`false`	Enable or disable auto-open
`delayMs`	number	—	Milliseconds to wait before opening (e.g., `15000` = 15 seconds)
`paths`	string[]	—	URL paths that trigger auto-open (supports regex patterns)
`exitIntent`	boolean	—	Open when the user’s cursor moves toward the browser close/back area

Behavior

Delay: Beacon waits for the specified delayMs after page load before auto-opening. If the user opens Beacon manually before the delay expires, the auto-open is cancelled.
Paths: Only triggers on pages matching the specified paths. Paths support regex patterns (e.g., "/app/.*" matches any /app/ subpage). If no paths are specified, auto-open applies to all pages.
Exit Intent: Detects when the user’s cursor moves toward the top of the viewport (suggesting they’re about to leave) and opens the panel. Only fires once per session.

Use Cases

Engage on Pricing Pages


{
  "triggers": {
    "autoOpen": {
      "enabled": true,
      "delayMs": 20000,
      "paths": ["/pricing", "/plans"]
    }
  }
}

Catch Exiting Visitors


{
  "triggers": {
    "autoOpen": {
      "enabled": true,
      "exitIntent": true,
      "paths": ["/checkout"]
    }
  }
}

Timed Engagement on All Pages


{
  "triggers": {
    "autoOpen": {
      "enabled": true,
      "delayMs": 30000
    }
  }
}