> For the complete documentation index, see [llms.txt](https://docs.eximee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/0-struktura-i-nawigacja/sekcja-section.md).

# Section - Section

Section component for grouping other components.

![](/files/38b367f7125eb66d91809b1220af77d35a7dd0fc)

✅ **When to use:**

* Do you want to group other components into a logical block (e.g. personal data).

:x: **When not to use:**

* It is only a simple separator without grouping content. **Use**: [HorizontalLine](/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/0-struktura-i-nawigacja/linia-horizontalline.md).
* There should be an option to enter the same type of data multiple times (e.g. children's data). **Use**: [Repeatable section](/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/7-komponenty-specjalne/sekcja-powtarzalna-repeatablesection.md).

## Component properties

<table><thead><tr><th>Eximee Designer property</th><th width="180.88330078125">Attribute name in the Source</th><th>Description</th></tr></thead><tbody><tr><td><strong>Title</strong> (section <strong>Basic properties</strong>)</td><td>title</td><td>Section title. It is possible to refer to variables or fields in the section title, e.g. <em>${sessionVariableName}</em> or <em>${GesTextField1}.</em></td></tr><tr><td><strong>Collapsible section</strong> (section <strong>Other</strong>)</td><td>foldable</td><td><p>Specifies whether the section should be collapsible. Default is "false" - non-collapsible.</p><p>Availability of functionality depends on the license and may not be available in all deployments.</p></td></tr><tr><td><strong>Section collapse condition</strong> (section <strong>Other</strong>)</td><td>foldedCondition</td><td><p>Section collapse condition - if it is met, the section is collapsed. For <strong>presentation</strong>=STANDARD, the condition is calculated at the very beginning and is used only for the first display of the section. For <strong>presentation</strong>=LABELS, changing the condition value causes the section to be modified (collapsed and expanded) while the application is displayed.</p><p>Availability of functionality depends on the license and may not be available in all deployments.</p></td></tr><tr><td><strong>Graphical representation of the field</strong> (section <strong>Other</strong>)</td><td>presentation</td><td><p>Specifies how the section expand/collapse is displayed. Available expand/collapse presentation types: STANDARD and LABELS (more detailed description below). Feature availability depends on the license and may not be available in all deployments.</p><p>Availability of functionality depends on the license and may not be available in all deployments.</p></td></tr><tr><td><strong>Dynamic section title</strong> (section <strong>Other</strong>)</td><td>sectionDynamicTitles</td><td>Allows section titles that depend on conditions to be specified. The first title in order whose condition is met will be displayed. If none of the conditions is met, the title provided in the property is displayed <em>title.</em> It is possible to refer to variables or fields, e.g. <em>${sessionVariableName}</em> or <em>${GesTextField1}.</em></td></tr></tbody></table>

> More information about component properties: [Common component properties](/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/wspolne-wlasciwosci-komponentow.md)

## Component dependencies in the section

When the value of a component on which the section depends changes, the state of the section and all components inside it are recalculated.

When any component in the section changes, the values of all components dependent on it are recalculated.

## Component arrangement (layout)

A layout can be defined on the section similarly to the layout for the application page (more in: [Changing component widths (layout)](/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/zmiana-szerokosci-komponentow.md)).

## Dynamic population of the section title

The section title can be dynamically populated, e.g. using session variables. If in the property *title* we enter a session variable in the form `${sessionVariableName}` then the section title will take the value of the session variable and each time the value of this variable changes, the section title will also change.

Another way to dynamically populate the section title is to use the property **Dynamic section title** ([Section - dynamic section titles](/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/0-struktura-i-nawigacja/sekcja-section/sekcja-dynamiczne-tytuly-sekcji.md)). In the displayed window, each subsequent title is added after clicking the button **Add dynamic section title**. In the column **TITLE KEY** you should enter the key previously defined in the **Translations** tab. The key value will be displayed automatically in the column **PREVIEW**. Define the condition as described in [Advanced condition editor](/documentation/documentation-en/budowanie-aplikacji/logika-biznesowa/jezyk-wyrazen-definiowania-warunkow-warunki-z-getvalue/zaawansowany-edytor-warunkow.md).

<figure><img src="/files/5a39689e88a860e3c8d9a8e22e0eb0d0828e748b" alt=""><figcaption><p><em><strong>Figure 1.</strong> Window for defining conditional section titles.</em></p></figcaption></figure>

In the property **Dynamic section title** conditions are defined for when the section title should change. If the condition `getValue("@GesCheckbox1")=="Y"` is met (i.e. Checkbox1 takes the value Y - is selected) then the section title will take the value (**PREVIEW**) specified for the defined key **TITLE KEY** (i.e. in this situation meeting the condition sets the section title to *"Title changed after clicking ..."*). If the condition is not met, the title provided in the property will be displayed **Title**.

<figure><img src="/files/e886f4e5e2f1265bfc2c5a5b555dc00e45165ce3" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/a74121b069d821ceb466cf83ea4d99468435c1da" alt=""><figcaption><p><em><strong>Figures 2 and 3.</strong> Dynamic feeding of the section title - preview on the application.</em></p></figcaption></figure>

## Section with the option to collapse/expand

{% hint style="info" %}
Availability of functionality depends on the license and may not be available in all deployments.
{% endhint %}

Two expand/collapse presentation types are available for sections (property **Graphical representation of the field**):

* **STANDARD** - section collapsible/expandable using a button located at the end of the section

<figure><img src="/files/3574f9b9d99b7a622588084a24ed8dfa90d9abf7" alt="" width="563"><figcaption></figcaption></figure>

* **LABELS** - section (without a title!) collapsible/expandable using the text set in **Label of the section collapse/expand button**.

<div data-with-frame="true"><figure><img src="/files/24dd395b3b224a58486c662136c39a42cf4890b6" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
If a validation error occurs on components located inside a collapsed section, the user will not be notified in any way and at the same time will not be able to proceed to the next page. It is the application designer's responsibility to provide an appropriate validator on the page.
{% endhint %}

{% hint style="info" %}
Demo application: demoSection
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/0-struktura-i-nawigacja/sekcja-section.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.