Group by section properties
To create a Group By section, select the tab that will contain the section and click the Add Section action. In the Properties panel for the new section, set the value of the Type property to Group By Section.
When you finish defining the properties of the Group By section, click the Apply action. To improve performance, the platform renders the Group By section but does not run the queries.
- Query
- Click the search icon to identify the query that defines the Group By section. See Query section properties.
- Group By
- This radio button is always selected and grayed out for Group By sections.
- Orientation
- Select either Horizontal or Vertical from the drop-down list to indicate whether the grid will be horizontal or vertical in appearance. It determines whether the Group By Columns and their respective values are laid out horizontally or vertically.


Although a Group By section has no automatically generated actions, you may want to define section actions. See Actions.
On section save, when not in create mode, the platform checks to make sure there is one and only one Group By field and at most one Group By order field. If either is not true, the platform displays a message and saves the section. On section publish, the platform makes the same validation; however, if either is not true, the platform does not publish the section. On section publish, if no query is specified, the publish fails. Use the Validate action to help find issues with the Group By section prior to section publish. The Validate action is described in Form Builder tabs and actions.