Skip to main content

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

Ensuring seamless upgrades of data pages

Updated on April 6, 2022

After upgrading your application to the latest version of Pega Platform, you might need to make changes to existing data pages. To ensure that data pages behave as expected after an upgrade, Pega Platform restricts you from making changes to a data page that are not backwards compatible with the previous version of the data page.

To learn which changes are restricted, review the following information:


  • If you change the class of the data page, the new class must inherit from the original class of the data page. This restriction applies if you overwrote a data page in the previous application, and then overwrote it in another application before upgrading.

    For example, you overwrite a data page that was originally part of the Customer class and changed the class to the Customer-Data class, which inherits from the Customer class. When you overwrite the data page again, you must choose a class that inherits from the Customer-Data class.

  • Do not change the structure of the data page, for example, from a Page structure to a List structure.
  • If the data page has parameters, do not make the following changes:
    • Change the type of parameter
    • Add new required parameters
    • Remove parameters
  • If the scope of your data page is Node, do not change the scope.
  • The following restrictions apply to changing the mode of a data page:

    ModeChange to Read-only allowedChange to Editable allowedChange to Savable allowed
For more information, see Understanding data page definition.

Unit testing

Unit testing is crucial for making sure that the data page behaves as expected after you make changes to it. For more information, see Unit testing a data page and Testing Pega applications.

  • Previous topic Configuring a data page for sourcing from robotic desktop automation
  • Next topic Unit testing a data page

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