Skip to main content

Configuration Sets

Configuration settings provide developers with a unified framework for customizing parameters for application behavior. The settings are organized into Configuration Sets that associate the settings with a common element, such as an application feature or specific Case Type.

Configuration settings and Configuration Sets provide low-code options for controlling application behavior. Configuration settings minimize the need for Rule overrides and custom Rule changes to help deliver applications that are easier to maintain, upgrade, and deploy. Minimizing custom Rule overrides shortens time-to-market and reduces the chance of introducing bugs or other issues during client development.

You can use Configuration settings in the following ways:

  • Control the use of features in an application - When a feature has dependencies, you can use Configuration settings to turn features off until the dependencies are met. For example, sending emails is often an Action available in many Processes. If the email integration has not been completed or must not be used in a specific environment, you can use a Configuration setting to disable the feature.
  • Determine which Process in a flow should be followed If approval is needed based on a monetary limit, for example, you can use a Configuration setting to maintain the monetary limit amount so that the number can be changed without modifying any code.
  • Control UI experience When an agile development methodology is used, Process changes are introduced with each release. You can use a Configuration setting to control the display of instructions for a change in an existing Process or for new Processes. Once users adopt the Process, you can update the Configuration setting to hide the additional instructions.
Note: In previous releases of Pega Platform™, Dynamic System Settings (DSS) provided the dynamic behavior functionality. Configuration settings should replace DSS to provide enhanced functionality and simpler maintenance.

To access Configuration Sets, navigate to the Configurations landing page by clicking Configurations in the Settings tab of App Studio:

Configuration settings

In the following image, click the + icons to explore the Configurations landing page:


    Configuration Sets are created and maintained in App Studio to group Configuration settings. Rules such as classes, Data Pages, and properties are created when developing Configuration Sets in App Studio and are visible in Dev Studio. The Rulesets applied to Configuration Sets are derived internally from open Rulesets available to the application. Configuration settings are data instances of the Data-Configuration-Setting class.

    Note: When a Configuration Set is first created, it will not appear on the Configuration landing until it has at least one Configuration setting. 

    In the following image, click the + icons to explore Configuration setting attributes:

        Configuration settings use role-based access controls (RBAC) to grant access for the standard administrator, manager, and user roles. The following table shows the default access for each role:


        Configuration Sets


        Configuration settings














        Note: An administrator can update access so that users and managers can write and delete Configuration Sets and settings.

          Configuration Sets are defined in the Pega-Configuration class structure and included in the deployment file that the product Rules generate. The name of the set is maintained as the pyLabel value of a class Rule and has a maximum length limit of 64 characters. Configuration settings are included when the Include associated data check box is selected during the product file creation.

          Applications and Components to include

          Referencing Configuration settings

          You can reference Configuration settings throughout the application with the Condition Builder. The Condition Builder provides a menu to select a Configuration Set and Configuration setting. 

          In the following image, click the + icons to explore how the Condition Builder references a Configuration setting:

          Check your knowledge with the following interaction:

          This Topic is available in the following Module:

          If you are having problems with your training, please review the Pega Academy Support FAQs.

          Did you find this content helpful?

          Want to help us improve this content?

          We'd prefer it if you saw us at our best.

          Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

          Close Deprecation Notice