Skip to main content


Hybrid mode

Suggest edit Updated on December 1, 2021
Applicable to Theme Cosmos applications

The hybrid mode in Theme Cosmos blends the speed and look of selected Cosmos React capabilities into the existing Pega Platform architecture. By supporting a mixed architecture, the hybrid mode helps you to progressively prepare your application for future changes.

Note: Cosmos React UI is not available for the Personal Edition version of Pega Platform.

Hybrid architecture

Theme Cosmos applications support a hybrid design that causes the UI to take on certain Cosmos React functionalities in an otherwise section-based UI. When you enable hybrid mode, most components retain the classic server-side rendering, but portal authoring components and tables use an updated client-side technology.

When creating a new application, you can choose between Theme Cosmos, Cosmos React, and a traditional UI Kit application. Theme Cosmos applications can use hybrid mode, or a standard architecture with sections only. For more guidance on how to choose a UI, see UI architecture comparison.

For more information on other UI architectures, see Cosmos React (early adopter) and Theme UI-Kit.


If you use Pega Cloud Services or a client-managed cloud environment to host Pega Platform, the Constellation engine, which powers React components, is already part of your development environment, and you only need to enable it for your applications.

If you run a client-managed cloud or an on-premises system that you implemented through Helm for Kubernetes, a single multitenant Constellation instance is installed automatically for each Pega Infinity environment. If you need a different configuration, you can also opt in by manually deploying the framework through Docker or Helm for Kubernetes. For more information, see Setting up the Constellation service in Pega Platform.

Security for a multi-tennant regional service in Pega Cloud Services

The Constellation Static Content Service (CSCS) for Pega Cloud Services is a Regional multi-tenant service. A single deployment serves the static UI content to all customers. The single CSCS also hosts cached static images from all of customers' Cosmos React applications. Customer images are protected by the same JSON Web Token (JWT) technology that protects calls to the Infinity service. Consequently, one customer cannot pick up images from another customer. The end user can only access images for the Infinity environment and application that they have logged on to.

Did you find this content helpful? YesNo

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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