Skip to main content

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

Configuring a region at run time

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

Forms that are based on design templates have one or more regions. Each region is marked with a name or with a capital letter (A, B, C, and so on, depending on the number of regions). At application run time, each region is displayed with this letter or name at the top. You can configure any region as you process a case. By making changes to regions in real time, you can develop your application in a dynamic and flexible way.

For information about regions in templates and forms, search for the article Section preview shows changes in real time for templated sections on Pega Community.
  1. To create a case, select a case type name from the New menu.
  2. On the lower right corner of the screen, click the Open runtime toolbar icon and then click Turn editing on.
  3. On the toolbar, turn on design mode by clicking the Toggle design mode icon (the square icon).
  4. Click the Configure this view icon for the region you want to edit.
  5. To add a header for the region or to change other default settings for the region:
    1. Click the Edit region icon next to the region letter (A,B,C).
    2. Select the Override default region settings check box in the Region properties modal dialog box.
    3. To include a header for the region, define the header title, format, and style.
    4. If the region does not contain fields, controls, or other elements, then you can prevent it from being displayed at run time by selecting the Hide region when empty check box.
    5. Click Submit.
  6. To add a section or control to a region, click the Add new icon and drag the element into the region.
  7. To change the sequence of elements within the region, move them up or down in the list. You can also remove elements from the region.
  8. If a region is marked as Grouped, the region is based on a layout group and you can do any of the following:
    • Set the layout group format to a different setting, such as Tab or Accordion, by clicking the Edit region icon and using the Format field on the Region properties dialog box.
    • Rename tabs.
    • Drag sections into the layout group from another region, or from the layout group into a different region.
  9. To add a field, view, or section, click the + icon and click an item in the list of available elements on the right. Click the Add to view icon to add elements that you want to include in the region. The green ball icon indicates that element has been added to a region.
  10. Click Done.
    Result: The changes that you made are displayed immediately.

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