Custom Mappings Beta

Set up and manage custom source-destination mappings.
Available Plans
  • free
  • starter
  • growth
  • enterprise

RudderStack’s custom mappings feature lets you control and manage your source-destination property mappings for Event Stream connections. It simplifies the mapping process, ensures consistency across all your events, and eliminates the chances of instrumentation errors.

With custom mappings, you can:

  • Reduce repetitive manual updates to your mappings.
  • Ensure tailored data handling and transformation based on specific requirements.
  • Review the updated mappings before applying them to your events.
  • Track the changes in your property mappings centrally.
info
Custom mappings is an early access feature. It is available only for the Google Analytics 4 v2 destination currently.

Set up custom mappings

  1. Create a new destination in RudderStack.
  2. In the Configuration tab, go to Event and property mappings and click Set up mapping:
Set up custom mappings in GA4
  1. Click Set up mapping. You will see the following two tabs:

Global Mappings

The Global Mappings tab summarizes all the distinct property mappings across all events. It also lets you edit/remove the mappings that are common across all the events in one go. This approach is helpful in case of destinations where there are common property mappings across multiple events.

Note that:

  • You cannot add a new global mapping or edit the greyed out destination fields.
Greyed out destination fields in global mappings
  • Editing the mappings in this tab updates the same mapping references across all events in the Event Level Mappings tab.
  • You can review the updated mappings before applying the changes. Any changes or updates made to the global mappings are highlighted in green.
success
You can also note the impacted events while reviewing the changes.
Review changes to global mappings

In the above image, the first line under Changes highlights the existing mapping and the second line indicates the updated mapping.

Once you click Apply changes to save the modifications, you are automatically redirected to the Event Level Mappings tab. Here, you can update the event-level mappings and save the changes.

Event Level Mappings

This tab contains the pre-populated property mappings for each event that is mapped to a destination event.

info

Note that:

  • Any changes in this tab affect only the specific event.
  • The changes are saved and propagated only if you click the Save button.
  • Each property is mapped using the jsonpath convention.

Add new mapping

Click the Add new event mapping option to specify a new mapping. In this view, you can:

  • Enter the RudderStack event name and the destination event you want to map.
  • Expand the Map your event property section to specify the custom property mappings.
Add new event mapping

Override global mappings for specific events

RudderStack automatically populates the global mappings applicable for each event in the Event Level Mappings tab. You can override these mappings by updating an existing mapping.

Override global mappings

Add property mapping for existing event

You can add a new property mapping for an existing event by expanding Map your event property and clicking Add row:

Add new event level mappings

Once you click Save, the new/updated mappings are visible in the Global Mappings tab and persisted in the backend:

New row in global mapping


Questions? Contact us by email or on Slack