Skip to main content


Data Transform form - Auto-map action

Suggest edit 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
Did you find this content helpful? YesNo

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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