> ## 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.

# Event mapping

> Configure how events should be mapped and forwarded to Destinations

## Introduction to event mappings

Event mappings tell Converge how to translate your Converge events to a destination.
For example, consider this mapping:

<Frame>
  <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/custom-mapping/mappings-0.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=81a23c2afe3b7081d90b4266a7f4cf3a" alt="mapping" width="1711" height="253" data-path="images/destinations/custom-mapping/mappings-0.png" />
</Frame>

This mapping tells Converge to forward an `AddToCart`-event to the destination, whenever an `Added To Cart`-event is tracked in Converge.

## Event Mapping Modes

Converge supports three mapping modes for most Destinations:

* **Use default mapping** (Recommended): Use the predefined Converge recommended mapping for the Destination.
* **Use custom mapping**: Configure your own event mapping rules to freely map your Converge events to the Destination.
* **Use server-side only** (if supported): Use only server-side event mappings. The corresponding pixel will not be installed and no event will be tracked client-side.

<Frame>
  <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/custom-mapping/mappings-1.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=34ed2108ead7aa87643da2134b4b378c" alt="default vs custom mapping" width="499" height="287" data-path="images/destinations/custom-mapping/mappings-1.png" />
</Frame>

<Note> Use custom mapping only if you have a specific use case and understand its impact. Use server-side only when you want to avoid client-side tracking entirely. </Note>

## Forwarding modes

Event mappings define not only how event names are translated, but also how events are forwarded.

There are three forwarding modes:

* **Client**: Forward the event to the destination client-side.
* **Server**: Forward the event to the destination server-side.
* **Client & Server**: Forward the event to the destination client-side and server-side.

<Note>
  Some destinations support only one forwarding mode. In those cases, you can map only events that match that mode.

  For example, if your `Cancelled Subscription`-event is implemented only server-side, you **cannot** map it to a destination that supports only client-side forwarding.
</Note>

## Modify your event mapping configuration

Converge allows you to configure mapping modes for all of your Destinations.

1. Navigate to the [Destinations Tab](https://app.runconverge.com/-/connections) in your Converge dashboard
2. Click on the destination for which you want to modify your mapping configuration.
3. Click on the **Configuration**, then click on **Event mapping** in the dropdown menu.
   <Frame>
     <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/custom-mapping/mappings-2.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=48d5c8716661e9619a1db2919509c2ed" alt="event mapping" width="1626" height="543" data-path="images/destinations/custom-mapping/mappings-2.png" />
   </Frame>
4. Click on the mapping configuration you'd like to modify, if you'd like to map a new event, click on **Add new mapping**.
   <Note> Default mappings can only be turned on or off, you cannot modify them. When using server-side only mode, only server-side mappings will be active. </Note>
5. Select an existing event or type in a new event you'd like to forward and then fill in the name you want to forward it as. Also choose the forwarding mode you'd like to use.
   <Info> For example, in the screenshot below, we forward an `AddToWishlist` event whenever a Started Checkout event triggers in Converge. The forwarding mode is set to Client & Server. </Info>
   <Frame>
     <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/custom-mapping/mappings-3.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=fe32a78fc872093c76fd15fdf985a061" alt="set up custom event" width="1247" height="714" data-path="images/destinations/custom-mapping/mappings-3.png" />
   </Frame>
6. Make any additional changes as needed. When you're satisfied with your mapping, click **Save**.
7. Use the [Destination Log](/destinations/monitoring#destination-logs) to confirm that your event is forwarding correctly.

<Note> Your configuration may take up to 10 minutes to take effect. Clearing your browser cache can help ensure you're testing the latest settings. </Note>
