> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Derived Events

> Create new events from existing events

export const OutboundLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget}> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-2.5 h-2.5 bg-gray-500 dark:bg-gray-300" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/up-right-from-square.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

## Overview

Converge lets you automatically create new events based on the properties of existing ones, without writing any code.

***

## Set up derived events

<Accordion icon="location-dot" title="How to set up derived events">
  1. Navigate to the <OutboundLink linkText="Derived events" linkTarget="https://app.runconverge.com/-/derived-events" /> page in your Converge dashboard.
  2. Click **Create new derived event** to start creating a new derived event.
  3. Fill in the **Derived Event Name**. This will be the name assigned to all new derived events matching your filter conditions.
  4. Under the filters, select a source event you want to trigger the creation of a derived event.
  5. Select the **Condition property**, **Condition operation**, and **Condition value** that the selected event's properties must match to create the derived event.
  6. Repeat for each condition as needed by clicking **Add condition**.
  7. Click **Save** to persist the derived event.
</Accordion>

Once configured, derived events will automatically be created whenever an event matches your specified filters. To forward these derived events to a destination, configure an [event mapping](/destinations/event-mapping#event-mapping) using the derived event name as the source event.

***

## Definitions

### Derived event

A derived event is any event you want to create that's triggered by an existing event's properties matching your desired filters. For example, you may want to track a `Subscription Purchase` event when a `Placed Order` event comes in that has a field `tag` containing the text `subscription`.

### Filters

Filters are used to define the conditions when a derived event should be created. They should include the name of the source event as well as conditions for each matching event property.

<Note>
  The `New Customer Order` derived event is created on setup for all users by default. It's not editable. It fires whenever a `Placed Order` event has `$is_new_customer` set to `true`. Prebuilt integrations like Shopify set this property automatically. Custom integrations should set it themselves, since Converge's fallback depends on the order history it already has on file. See [New customer status](/sources/concepts/new-customer-status) for the full rules.
</Note>

A condition consists of three parts:

* **Condition variable**: a variable to be compared. It can be any of the event's available properties (e.g. `Product names`, `coupons`, etc.).

* **Condition operator**: a condition to be applied to the variable.

* **Condition value**: the value to be compared against the variable.

<Note>
  The filters only work on the event's properties. Currently, it doesn't allow filtering on attribution, profile properties, session properties, or sources.

  For example, if you want to create derived events matching a certain condition from a particular source, you can't do this at the moment.
</Note>