Skip to main content

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

Adding a dynamic container to a portal

Updated on December 13, 2022
Applicable to Theme Cosmos applications

Define the main area of your portal by specifying where your application opens documents, such as cases or pages, and provide your users with a clear and intuitive workspace.

Dynamic containers display content in the main pane of the portal. You can define a default view for a container, but if the user opens a document, the application replaces the default view with the selected content, without reloading the portal. This architecture helps users access documents without page refreshes, which reduces context switching and improves the user experience.

Each portal supports only one dynamic container.

Note: When you create a portal in App Studio, Pega Platform generates the dynamic container automatically.
  1. In the navigation pane of Dev Studio, click Records.
  2. Expand the User Interface category, and then click Section.
  3. Open the section to which you want to add a dynamic container.
  4. If the editing options are not visible, in the header of the section editor, click Convert to full section editor, and then confirm the conversion.
  5. On the Design tab, expand the Structural list, and then drag the Dynamic container onto the design canvas.
  6. In the Dynamic Container Settings window, select Single document.
  7. In the Default view list, select Section.
  8. In the Page context list, select Use current context.
  9. In the Section field, select the section that you want to display in the dynamic container.
  10. Select the Render as single page checkbox.
  11. Optional: To enable processing in multiple separate browser tabs, without sessions refreshing and overriding one another, select the Allow concurrent work in multiple tabs/browsers checkbox.
  12. Click OK.
  13. On the section form, click Save.

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