WebsiteCommunity

System Events

Engage users instantly with built-in system events that require no integration and drive retention from day one

Overview

System Events are predefined user actions tracked by default to help you build flexible and engaging mission flows, without API integration. They lower the barrier to launching retention-focused missions, especially for non-technical teams or no-code clients.

System Events help you shape meaningful user behaviors from Day 1:

  • Referral → encourage acquisition through peer invites and community growth

  • Widget Open → launch missions to boost return visits and habit formation

  • Hold to Earn → reinforce core staking actions by rewarding both volume and frequency

Setup and Use

Installing System-Based Events

When the Event-Based Missions feature is installed, 3 System Events are automatically added to the Events tab:

  1. Hold to Earn

  2. Referral

  3. Widget Open

System Events are created automatically, but depend on the related feature being installed and active.

System Events (Events tab)

Using System Events in Missions

After installation, System Events become selectable in the mission builder under the “Choose Event” field.

Selecting Systems Events (Missions creation page)

You can build missions around these events using either:

  • Count of Events (number of times the event occurred)

  • Amount of Events (total value associated, available for Hold to Earn only)

Feature dependencies

  • Hold-to-Earn and Referral events are tied to their respective features.

  • These System Events:

    • Will be available only if the related feature is installed.

    • Will be removed from the Events list if the feature is uninstalled.

    • Will also disappear from the mission builder and become unavailable for new missions.

If there is an active mission using Referral or Hold to Earn events, and the related feature is later uninstalled, the mission will remain visible on the widget but cannot be reused or edited with that event type.

Events behavior & rules

  • System Events appear at the top of the Events list.

  • They are Active by default after installation.

  • Editable & Translatable — You can customize names and labels.

  • Status toggle is enabled — You can deactivate them.

  • Deletion is disabled — You cannot remove System Events.

System Event-based Missions examples

🔗 Referral System Event:

Mission — "Invite 5 friends"

  • Encourages viral sharing and network growth

  • Condition: Count of Events = 5

⭐ Widget Open System Event:

Mision — "Visit the widget for 5 days in a row"

  • Builds a usage habit and increases daily engagement

  • Condition: Count of Events = 5

  • Enable “Count once per day”

🪙 Hold to Earn System Event: Mission — "Make 5 Stakes"

  • Reinforces regular interaction with the staking feature

  • Condition: Count of Events = 5

🪙 Hold to Earn System Event:

Mission — "Stake 10,000 tokens" — Drives higher value activity and deeper commitment

  • Condition: Amount of Events = 10,000

Last updated