Skip to main content

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

Page-Set-Messages method

Updated on August 10, 2022

Use the Page-Set-Messages method to add a message to a clipboard page. Like a message associated with a property, a message associated with a page normally prevents the page from being saved into the database. If the page is an embedded page, the message is added to all its parent pages.

A later Page-Clear-Messages method applied to the same page removes the messages set by this method. In addition, page messages are cleared when a workstation user submits an HTML form to the Pega Platform server that includes values for properties on that page.


This method has three parameters:

Page Enter a named page from the Pages & Classes tab to contain the message. Use the keyword Primary for the primary page.

This field is optional. If you leave it blank, the system uses the step page, or the primary page if no step page is specified.

Category Enter a localization category that is the second key part of a field value. The default is pyMessageLabel.

Otherwise, leave this field blank.

Message Identify the message to add to the page. You can enter values in this field in one of the following ways:
  • The name of a Rule-Message instance, without quotes. The list of available options in the SmartPrompt is limited to Error and blank category messages of the class of the specified Page.

    If the message supports parameters, append a tab-delimited string to the message name.

  • The third key part of a field value rule where the class of the specified Page is the first key part and the value specified in the Category field is the second key part.

    Use this approach when the Category field is not blank and the specified field value does not contain property references. Property references can lead to confusion because field values are evaluated each time the page is read, and property values can change over time.

  • A literal text string within double quotes.

    Avoid this option if your application supports localization.


The message becomes associated with the page as a page message.

Checking the method status

This method updates the pxMethodStatus property. See How to test method results using a transition.

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