> 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/2-pola-wyboru/kafel-tile/grupa-kafli-tilegroup.md).

# Tile group - TileGroup

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

A single-choice group whose options are graphically represented by tiles

![](/files/8d4b03b680ad0df7265e1c59cdb28bc66099df69)

## Component properties

| Eximee Designer property                                                       | Attribute name in Source | Description                                                                                                                                                             |
| ------------------------------------------------------------------------------ | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Label<br>(section <strong>Basic properties</strong>)</p>                    | label                    | Label for the component.                                                                                                                                                |
| <p><strong>Number of columns</strong><br>(section <strong>Layout</strong>)</p> | columns                  | Number of columns in the component - this value is taken into account only when the component's domain is populated by **external data source** (External Data Source). |

> 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 value

The value of the field selected by the user is set as the component value **Tile** ([Tile - Tile](/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/kafel-tile.md)). No selection means that the property **value** of the component is an empty string.

## Internal components

Inside the component **Tile group** one type of component can be embedded — **Tile** (component description in [Tile - Tile](/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/kafel-tile.md)). The arrangement of components inside **the tile group** can be specified using the field **Number of columns** available in the section **Layout**.

## Component input parameters

| Parameter             | Description                                                                                                                                                                                                                                                                      |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **id**                | The value taken by the selected tile (required field). An empty value returned by the service will cause a system error.                                                                                                                                                         |
| **content**           | Tile content written in HTML (scripts inside this HTML are not supported by the platform).                                                                                                                                                                                       |
| **additionalContent** | Additional tile content written in HTML (scripts inside this HTML are not supported by the platform). Functionally, it may behave differently depending on the selected implementation, for example, content that is to be additionally displayed when a given tile is selected. |
| **title**             | Tile title.                                                                                                                                                                                                                                                                      |
| **columns**           | Number of columns over which the tiles are to be arranged (optional field). The value returned by the service overrides the value set in the Number of columns parameter.                                                                                                        |
| **value**             | The value the group will take after the domain is populated (optional field). If a value outside the domain is returned, the default value will be set (if it is in the new domain) or left empty.                                                                               |
| **popupTriggerLabel** | Label text whose click will show the popup (optional functionality. Not available in all implementations.)                                                                                                                                                                       |
| **popupTextContent**  | The name and version of the content text (in name-version format) that will be shown in the popup (optional functionality. Not available in all implementations.)                                                                                                                |

## Clearing the selection

To clear the current selection, set an empty value for the component (**value**), where an empty value means an empty string: "". It should also be noted that resetting the selection does not mean restoring the default value, but deselecting the currently selected Tile.

<figure><img src="/files/94afb000d58278846d2db802f88dd1bb59695788" alt=""><figcaption><p><em><strong>Figure 1.</strong> Example appearance of the component on the form.</em></p></figcaption></figure>

<figure><img src="/files/9d551ea9b27097deb4c18f5d3e4ef9f4ecbc4dfc" alt=""><figcaption><p><em><strong>Figure 2.</strong> Example appearance of a component with tiles containing a title.</em></p></figcaption></figure>

{% hint style="info" %}
Demo conclusions: demoTileGroup
{% endhint %}

{% hint style="info" %}
♿WCAG: [WCAG best practices for low-code dev](https://github.com/Consdata/eximee-docs/blob/main/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/proces-biznesowy/tworzenie-procesu-biznesowego-w-bpmn-2.0/dobre-praktyki.md)
{% 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:

```
GET https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/kafel-tile/grupa-kafli-tilegroup.md?ask=<question>
```

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.
