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.

About the UI Kit

Updated on September 17, 2019

The UI Kit provides application architects and user interface (UI) designers with a sample end-user UI that reflects the latest design trends and Pega 7 Platform UI capabilities. With the UI Kit, you can take advantage of the most recent UI capabilities of the Pega 7 Platform to create your own modern, responsive UI in your applications.

Pega 7 Case Manager portal

Pega 7 Case Manager portal provided in the UI Kit

The UI Kit user portals

The UI Kit has two user portals: the Case Manager portal and the Case Worker portal.

The initial version of the UI Kit, released as part of Pega 7.1.6, included only the Case Manager portal. The Case Worker portal was added to the second version, released as part of Pega 7.1.7.

Both portals incorporate the latest Pega 7 Platform UI features to provide end-user interfaces that reflect the latest UI design trends. While you can use these portals as-is in your application, the UI Kit is intended to be used as a starting point for creating and customizing your own end-user UI.

The UI Kit skin

The UI Kit includes pyEndUser as the default skin for applications. When you create an application, the skin automatically inherits styles and formats from pyEndUser. To change a style in your application, you need to edit the style in your application’s stylesheet to override the formatting inherited from pyEndUser.

Some user interface elements are disabled by default in the UI Kit. Smart layouts and panel sets are disabled because they are replaced by dynamic layouts and screen layouts. Repeat row columns, accordions, smart labels, and list views are disabled because those components are deprecated in Pega 7.2.

Using the UI Kit

The UI-Kit-7 ruleset added to an application ruleset stack in Pega 7.1.8The UI Kit is provided as a stand-alone ruleset, named UI-Kit-7. Unlike other rulesets that are provided as part of the Pega 7 Platform installation, the UI-Kit-7 ruleset is not a part of the PegaRULES application. Instead, Application Express adds the UI-Kit-7 ruleset to the application rule when you create an application that is based on the PegaRULES application.

  • All applications created in Pega 7.1.6 and later versions incorporate the UI Kit automatically.
  • For applications that were created prior to 7.1.6 and migrated to a Pega 7.1.6 or later installation, add the appropriate version of the UI-Kit-7 ruleset to the list of application rulesets on the application rule.
The UI-Kit-7 ruleset is not available on versions of the Pega 7 Platform prior to 7.1.6.

Pegasystems publishes the UI-Kit-7 ruleset as a locked ruleset. To customize the Case Manager and Case Worker portals provided by the UI Kit, you must copy the rules to an unlocked application ruleset.

If you plan on customizing the provided UI Kit portals, import the entire UI-Kit ruleset into your application ruleset. When upgrading your application, be sure to include your customized version of the UI-Kit when you upgrade to maintain your custom styles.

Updates to the UI Kit

All updates to the UI-Kit-7 ruleset coincide with a maintenance level release of the Pega 7 Platform.

Each update to the UI Kit is published as a new major release to avoid any conflicts that rule resolution might cause. This allows you to standardize your UI on a specific version of the UI Kit, and to control when you upgrade to a later version. 

Because individual UI Kit versions might not be fully backward compatible, every upgrade to a new UI Kit requires development effort. For instance, you might need to adjust certain CSS parameters and sections to keep styling and application behavior consistent between the previous and the current version of the application. 

UI Kit upgrades are optional. Because each new release of the Pega Platform ships with all previous versions of the UI Kit, you can keep using your version of the application to avoid development effort.

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