Skip to main content

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

Learning about containers in portals

Updated on November 15, 2021
Applicable to Theme UI-Kit applications

A portal is an interface through which users access documents, such as cases, dashboards, and pages. You use containers to arrange these items on the screen, and create a familiar work environment for your application.

The main area of a portal consists of a container that defines where new documents open on the screen. When you generate a portal through App Studio, Pega Platform creates the container automatically, based on the portal template. When the application starts, the container displays the content that you specify as default content during portal creation.

For example, if you choose Dashboard as the default content, the container initially points to the Dashboard harness. At run time, whenever the user opens a new document, the container is reloaded to display that content, but the portal is not. This architecture improves performance and reduces context switching.

If you design your portal in Dev Studio, you must manually create your containers.

Containers embed sections or harnesses in a portal. Depending on your needs, you can use the following types of containers:

Dynamic container
You can use dynamic containers only in the main pane of the portal, and a portal can have only one dynamic container.
AJAX container
You can use AJAX containers anywhere in a portal, and a harness can have up to three AJAX containers. This type of container also supports conditional logic, such as when rules, and can be configured for different roles. For example, an AJAX container can be an expandable pane that offers supplementary case information and is only visible when the user requests that data.

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