# Section settings ## Settings shared with grids See [Section and grid settings](https://doc.orbeon.com/form-builder/form-editor/container-settings). ## Basic settings ### Overview ![](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-11604b458c173c3982e89da1966b210e98fb0056%2Fsection-settings.png?alt=media) ### Section collapsing \[SINCE Orbeon Forms 2016.1] The following only applies when the form doesn't use the [Wizard view](https://doc.orbeon.com/form-runner/features/wizard-view). A section can be open/expanded or closed/collapsed. By default, sections are open when the form loads, unless the "Initially open" checkbox is *deselected*. The "Collapsible" radio buttons control whether the user can collapse and expand sections: * **Use property:** use the configuration specified with the `oxf.xforms.xbl.fr.section.collapsible` property * **Always:** the section is collapsible no matter what the `oxf.xforms.xbl.fr.section.collapsible` property specifies * **Never:** the section is not collapsible no matter no matter what the `oxf.xforms.xbl.fr.section.collapsible` property specifies ## Repeat settings See [Repeat settings](https://doc.orbeon.com/form-builder/form-editor/repeat-settings). ## Label, help message, and short labels The label can be configured directly in the form area, by clicking on the section title, or in the "Label" tab. The help message is configured in the "Help Message" tab. Similarly, the help message can be in plain text or use rich text (HTML). [\[SINCE Orbeon Forms 2023.1\]](https://doc.orbeon.com/release-notes/orbeon-forms-2023.1) A short label can be configured in the "Short Label" tab. This short label is used instead of the regular label in the table of contents when using the [wizard view](https://doc.orbeon.com/form-runner/features/wizard-view). ![](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-bf36d1bce35e4543d9b2013188bb7c4770834493%2Fsection-settings-short-label-1.png?alt=media) ![](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-dc44e0715d8f3fca24026e88db0d3cd3162f4922%2Fsection-settings-short-label-2.png?alt=media) ![](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-d08d28759fd5a7cbf1ccb600c348e2bf6cf4a53d%2Fsection-settings-short-label-3.png?alt=media) [\[SINCE Orbeon Forms 2023.1.3\]](https://doc.orbeon.com/release-notes/orbeon-forms-2023.1.3) Section labels are now optional. If you don't provide a label in any language, by leaving it blank, the section title will not be displayed. For more, see [Optional Section Labels](https://www.orbeon.com/2024/05/optional-section-labels). ### Dynamic label and help message \[SINCE Orbeon Forms 2018.1] In most cases, labels and help messages are simply localized messages without dynamic parts. However, sections also support *dynamic* labels and help messages. This means that, instead of being specified once and for all at form design time, labels and help messages can incorporate dynamic parts such as control values and other custom expressions. For more, see [Template syntax](https://doc.orbeon.com/form-builder/advanced/template-syntax). ![](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-459f62aaf0dfbe7f3824d9230f0f42ab3a626485%2Fsection-settings-label.png?alt=media) ![](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-43b43e5c4654804629c4fdb5d9e7b27cc724dfa2%2Fsection-settings-help.png?alt=media) ### Dynamic iteration label \[SINCE Orbeon Forms 2019.1] For sections with repeated content, the "Repetition Label" tab allows you to set a label that applies to individual repetitions. Typically, this label will use a template so that values from the repeated content can be used. When using the [Wizard view](https://doc.orbeon.com/form-runner/features/wizard-view), repetition labels will show in the Wizard's table of contents. ![](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-afc9df258a1e7e3970894a38d43442a4fd992f06%2Fsection-settings-repetition-label.png?alt=media) ### Custom "Add Repetition" label \[SINCE Orbeon Forms 2022.1] For sections with repeated content, the "Add Repetition Label" tab allows you to set a label that applies to the button used to add repetitions. ![](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-232bfcfc234b465a543f2c3a08c0895e60d720d2%2Fsection-settings-add-repetition-label.png?alt=media) ## See also * [Section and grid settings](https://doc.orbeon.com/form-builder/form-editor/container-settings) * [Grid settings](https://doc.orbeon.com/form-builder/form-editor/grid-settings) * [Repeat settings](https://doc.orbeon.com/form-builder/form-editor/repeat-settings) * [Repeated grids](https://doc.orbeon.com/form-builder/form-editor/repeated-grids) * [Formulas](https://doc.orbeon.com/form-builder/formulas) * [Section component](https://doc.orbeon.com/form-runner/component/section) * [Template syntax](https://doc.orbeon.com/form-builder/advanced/template-syntax) * [Wizard view](https://doc.orbeon.com/form-runner/features/wizard-view) * Blog post: [Optional Section Labels](https://www.orbeon.com/2024/05/optional-section-labels) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://doc.orbeon.com/form-builder/form-editor/section-settings.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.