Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Data Transform form - Auto-map action

Updated on November 15, 2021

Use the Auto-map action to contextually and automatically map data from JSON to the clipboard or from the clipboard to JSON.


Use the Auto-map action with a Page or Page List property that has a data model of the property's page class that exactly matches the JSON data model. The name and type of every child field is the same in both the JSON data and the clipboard.

Note: To ensure that the Auto-map action runs properly, as a best practice, define the desired Pega Platform data model in your application hierarchy.

For more information about mapping and JSON serialization and deserialization, see the following articles on Pega Community:

  • Using the mapping API for high-performance JSON serialization

  • Using the mapping API for high-performance JSON deserialization

Relation column

The Auto-map action has a fixed Relation field setting of To. That is, the Auto-map action always sets the target to the source and establishes no other sort of relationship between the two.

Note: When serializing JSON, the source is clipboard, and when deserializing JSON, clipboard is the target.


The only property type values supported are:

  • Page
  • Page List
  • Previous topic Data Transform form - Apply Data Transform action
  • Next topic Data Transform form - For Each Page In and Exit For Each actions

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us