Skip to main content
Muta allows you to emit custom events from your flows using the platform’s behavior system. You can configure custom events in the Muta web editor and listen for them in your app to trigger specific actions.

Setting Up Custom Events

  1. In the Muta web editor, add an “Emit Event” behavior to any element
  2. Give your event a unique name (e.g., signup_started, premium_selected, survey_completed)
  3. Optionally add custom data to pass along with the event

Example Usage

Custom Event Structure

Common Use Cases

User Actions

Track when users click specific CTAs or make choices:
Trigger app navigation based on flow interactions:

Data Collection

Gather form submissions or survey responses:

Feature Flags

Enable/disable features based on onboarding choices:

Conversion Tracking

Track specific conversion events:

Best Practices

  1. Consistent Naming: Use descriptive, consistent event names across your flows
  2. Type Safety: Consider creating a TypeScript interface for your custom events
  3. Error Handling: Always validate eventData before using it
  4. Documentation: Document your custom events and their expected data structure
  5. Analytics Integration: Forward custom events to your analytics provider for tracking
  6. Cleanup: Always remove event listeners when components unmount to prevent memory leaks