Skip to main content

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


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

Sections are the building blocks of your user interface. You can populate a section with components, such as fields and controls, to create a functional chunk of user interface that can be reused in different contexts for improved consistency and efficient development.

Sections are instances of the Rule-HTML-Section class and define how an area of a user interface looks. You can display a section in a harness, another section, or a paragraph rule.

Sections use templates that organize content into separate regions. Each region can contain properties, labels, controls, and other sections. You can create a custom template specifically for your application, or choose from several out-of-the-box templates that cover most UI scenarios.

For example, your application may need to display user data as a list of ID cards. To create a section that is the basis of a card, you can apply the list item template to the section, and populate it with references to properties that store user data. You can then include the section in a repeating layout, and the application uses it as a model for all user ID cards in that layout. Because the system sources all cards from the same section, they share the visual design and the type of data that they display. However, the content of each card is different because the data is independent of the user interface design.

  • Creating sections

    Use sections to build a modular user interface that promotes reusability and design consistency. By populating your sections with content, you can create a functional chunk of interface that has a specific purpose, and can be used in many contexts.

  • Sections - Completing the Create or Save As form

    Records can be created in various ways. You can add a new record to your application or copy an existing one. You can specialize existing rules by creating a copy in a specific ruleset, against a different class or (in some cases) with a set of circumstance definitions. You can copy data instances but they do not support specialization because they are not versioned.

  • Section form - Completing the Design tab

    This tab displays a preview of a section. A section is an element of your user interface that is comprised of layouts and cells.

  • Settings tab of the Section form

    Use the Settings tab to configure a section as a work area, design template, dashboard layout or widget, or email template.

  • Section form - Completing the Parameters tab

    Optional. Identify parameters for this section.

  • Control form - Completing the Pages and Classes tab

    Identify what is known about the class of each page that is referenced in the source HTML on the HTML tab.

  • More about Sections

    Pega Platform resolves a reference in a harness to a section during stream processing, by evaluating the<pega: include > JSP tags (or include directives).

  • More about report definition rules

    About the pxRetrieveReportData activity

  • Unit testing a section

    After you create a section rule, you can run the rule to test it in the context of the application you are developing. Specify a test page for the rule to use, provide sample data as the input, run the rule, and examine the results.

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?

100% found this content useful

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