Skip to main content


   This documentation is for current versions. Go here for the non-current versions.

Theme Cosmos 4.0

Suggest edit Updated on February 24, 2022

The Theme Cosmos design system is a complete library of UI components for building Pega Platform applications. You can use Theme Cosmos with a classic or hybrid section-based architecture and with the latest Cosmos React view-based architecture.

In the 8.7 version of the Pega Platform, new section-based applications use Theme Cosmos by default. For more information, Pega Cosmos.

Caution: Upgrade impact

To use the new features in existing applications, you must manually update the Theme Cosmos ruleset in the application stack. Updates to the Cosmos Theme ruleset might require development effort. For example, after an update, the styling or behavior of your application might change. For more information, see Updating the Cosmos theme in your application.

Support for archived cases

Applications that use version 4.0 of Theme Cosmos now support archived cases. Users can now search, retrieve, and print archived cases, also when using mobile apps. This enhancement improves application usability by adding a crucial, customer-requested feature to the Pega Platform stack.

New application header

Applications that rely on Theme Cosmos and use either the Cosmos React or section-based architecture can now use a new type of header. The new header is a bar that spans the top of the page and includes the following information: a logo, the application name, the operator menu, as well as a global search box. In section-based applications, the search engine displays a consolidated lists of results in a confenient table. By giving users a quick way to distinguish between portals, this enhancement is particularly useful to businesses that run many Pega applications.

For more information, see Defining a portal header.

Related cases widget

The work area in Theme Cosmos now includes the Related cases widget, which you can use to add and remove case instances that are relevant to your work. For example, in a collective insurance case, you can add the insurance cases of individuals to enhance the process of analysis.

Support for multiple file attachments widget

Theme Cosmos now supports the classic multiple file attachments in UI Kit version 11.0 and earlier. The widget, which attaches the files directly to the case, provides users with tools to upload multiple files simultaneously and define attachment categories for each uploaded file.

You can enable this feature by replacing the pyCaseRelatedContent section that holds the Files and documents widget with the pyCaseAttachmentWrapper rule.

Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

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

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us