Events

Overview

The SDK fires custom DOM events at two distinct times:

1. Boot-time events - Fire during SDK initialization
2. User-action events - Fire in response to user interactions

Understanding this distinction helps you integrate correctly. Boot-time events tell you when features are ready; user-action events let you respond to user behavior.

Listening to Events

document.addEventListener('PelcroUserLoggedIn', (event) => {
  const user = event.detail;
  console.log('User logged in:', user.email);
});

All events follow this pattern:

• Events are dispatched on document
• Event data is available in event.detail
• Events bubble and are not cancelable

Boot-Time Events

These events fire during SDK initialization. Use them to know when features are ready.

AdBlock Detection Events

User-Action Events

These events fire in response to user interactions or API calls.

User Events

Subscription Events

Payment Events

Address Events

Password Events

Newsletter Events

E-commerce Events

Paywall Events

These events can fire during boot (automatic paywall) or at runtime (manual trigger).

Deprecated Events

These events still work but should not be used in new integrations.

Related

• Modules - Methods that trigger these events
• JavaScript SDK - Installation and setup