Merge pull request #7027 from segmentio/duplicate-mappings

Duplicate Mappings

Author: forstisabella

src/connections/destinations/actions.md

@@ -249,6 +249,21 @@ You can combine criteria in a single group using **ALL** or **ANY**.  Use an ANY
 >
 > If your use case does not match these criteria, you might benefit from using Mapping-level Triggers to match only certain events.
 
+## Duplicate Mappings
+
+You can use the Duplicate Mappings feature to create an exact copy of a mapping. The duplicated mapping has the same configurations and enrichments as your original mapping. 
+
+Duplicate Mappings supports [Actions destinations](#actions-destination), [Reverse ETL destinations](/docs/connections/reverse-etl/reverse-etl-catalog), and destinations connected to Engage [Audiences](/docs/engage/audiences) and [Journeys](/docs/engage/journeys).  
+
+To duplicate your mappings: 
+
+1. Navigate to **Connections > Destinations** and select the destination with the mappings you'd like to copy. 
+2. On the destination's **Mappings** tab, select the menu button (**...**) and click **Duplicate Mapping**. 
+3. Review the popup and click **Duplicate Mapping**.
+
+Segment creates a disabled mapping with the name "Original Mapping Name (Copy)". You must enable the mapping for data to flow. 
+
+
 ## FAQ and troubleshooting
 
 ### Validation error when using the Event Tester

src/connections/reverse-etl/setup.md

@@ -98,6 +98,9 @@ To create a mapping:
 12. Turn the toggle on for the **Mapping Status**. Events that match the trigger condition in the mapping will be sent to the destination.
     * If you disable the mapping state to the destination, events that match the trigger condition in the mapping won’t be sent to the destination.
 
+> success ""
+> Use Segment's [Duplicate mappings](/docs/connections/destinations/actions/#duplicate-mappings) feature to create an exact copy of an existing mapping. The copied mapping has the same configurations and enrichments as your original mapping.
+
 ### Supported object and arrays 
 
 When you set up destination actions in Reverse ETL, depending on the destination, some [mapping fields](/docs/connections/reverse-etl/setup/#step-4-create-mappings) may require data as an [object](/docs/connections/reverse-etl/manage-retl/#object-mapping) or [array](/docs/connections/reverse-etl/manage-retl/#array-mapping). 

src/engage/audiences/send-audience-data.md

@@ -64,4 +64,7 @@ You can add and access mappings within your audience's connected destination by
 4. In the **Add Mapping** popup, select the mapping that you want to add.
 5. Segment then opens the destination's mappings tab. Add the mapping(s) you want, then click **Save**.
 
-Segment then returns you to the audience's destination side panel, which shows your new mapping(s).
+Segment then returns you to the audience's destination side panel, which shows your new mapping(s).
+
+> success ""
+> Use Segment's [Duplicate mappings](/docs/connections/destinations/actions/#duplicate-mappings) feature to create an exact copy of an existing mapping. The copied mapping has the same configurations and enrichments as your original mapping.

src/engage/journeys/send-data.md

@@ -45,6 +45,8 @@ To use Trait Activation with Journeys:
 2. Select [a supported](/docs/engage/trait-activation/trait-activation-setup/#set-up-a-destination) destination from a journey step.
 3. Select **Customized Setup**, then add identifier and trait mappings to customize the way you send data to your destination. For more, visit the [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/#customized-setup/) and [ID Sync](/docs/engage/trait-activation/id-sync/#customized-setup/) setup docs.
 
+> success ""
+> Use Segment's [Duplicate mappings](/docs/connections/destinations/actions/#duplicate-mappings) feature to create an exact copy of an existing mapping. The copied mapping has the same configurations and enrichments as your original mapping.
 
 ## What events are sent to destinations?