Skip to main content

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

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

When Condition rules

Updated on April 5, 2022

A when condition rule evaluates a Boolean logical statement involving comparisons among values of properties, to return true or false.

The following tabs are available on this form:

Where referenced

Rules of many other rule types can reference when condition rules. For example, you can reference when condition rules in activities, flows, and through the <pega:when > JSP tag in HTM and XML rules.


Use the Application Explorer to access when condition rules that apply to the work types in your application. Use the Records Explorer to list all when condition rules available to you.


Many when condition rules can be conveniently expressed as one or more Boolean expressions (comparisons or function calls) ANDed or ORed together. Use the Conditions tab to enter or update such rules. Other when condition rules require more complex logic to combine the Boolean expressions. Use the Advanced tab to enter or update those rules.


After you complete initial development and testing, you can delegate selected rules to line managers or other non-developers. Consider which business changes might require rule updates and if delegation to a user or group of users is appropriate.

For more details, see Delegating a rule or data type.


When condition rules are part of the Decision category. A when condition rule is an instance of the Rule-Obj-When rule type.

  • Creating a When rule

    Evaluate a Boolean logical statement that involves comparisons among values of properties, to return true or false, by creating a When rule.

  • Defining conditions for a When rule

    Enter or revise a When rule that can be expressed as a single Boolean expression or the conjunction (AND or OR) of one or more Boolean expressions.

  • Editing a When rule in the legacy mode

    Apply functions and more advanced logic in When rules by editing the conditions in the legacy authoring mode.

  • Configuring advanced options of a When rule

    Define complex logic strings and use functions in conditions by configuring advanced options of a When rule.

  • Specifying pages and classes of a When rule

    Ensure that a When rule accesses or updates information on clipboard pages by specifying the page name and class of the pages. At run time, these pages contain the properties that are referenced on the other tabs of a When rule.

  • More about When Condition rules

    You can compare the value of one property reference against a literal constant, or against the value of another property reference. If you define more than one comparison, you can combine the results with and, or, and not operations to determine the final true/false outcome.

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