> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Container

> A container in FlowX.AI is a versatile building block that empowers you to group components and arrange them as needed, providing flexibility in UI design. It can also serve as the root component for your design.

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/container_ex.gif)

The following properties can be configured in the container:

## Properties and settings

### Settings (applicable across all platforms)

These settings added in the **Generic** tab are available and they apply to all platforms including Web, iOS, and Android.

#### When used as root

When employed as the root component, the container offers the following settings:

* **Custom UI payload**: A valid JSON describing the data sent to the frontend when the process reaches a specific user task.
* **Expressions (Hide condition)**: JavaScript expressions utilized to dynamically hide components based on conditions. In the **Expressions** section, click **+**, set **Type** to **Hide**, then enter the expression.

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/container-root-expression.png)

#### When not used as root

When the container is not used as the root, you can configure a **Hide** expression under **Expressions**, **Permissions**, and the **Data test ID** under **Advanced**.

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/container-child-expression.png)

With containers, you gain the ability to structure your UI elements efficiently, enhancing the overall design and usability of your application.

There is no fixed maximum number of containers on a screen. For performance, limit component density and nesting depth as described in the [screen configuration guide](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/screen-configuration-guide.md).

### Container settings overrides

You may want to override settings configured in the **Generic** tab to be displayed differently on mobile devices.

* **Hide expressions**: Use Overrides in the Settings tab to hide a container on a specific platform.

> [!NOTE]
>
> For instance, you can set a container to appear on all platforms, or create an override to hide it on mobile but show it on web.
>
> ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/override_hide.gif)

To achieve this:

1. Select a Container element in the UI Designer and pick the platform in the platform selector in the header. In the **Settings** tab, find the overrides section for that platform (for example, **Web overrides**), click **+**, then choose **Expressions** > **Hide**.

2) Add your JavaScript Hide condition.

## Styling

> [tab] Web
>
> > [tab] Layout
> >
> > When designing for the web, consider the layout options available for the container. These options include:
> >
> > * **Position**
> >   * **Static** (default): The container stays in the normal page flow and scrolls with the content.
> >   * **Sticky**: When the sticky property is enabled, the container maintains its position even during scrolling.
> >     * **Sticky layout**: You have the option to specify minimum distances between the container and its parent element while scrolling. At runtime, sticky containers will keep their position on scroll relative to top/ bottom/ right/ left margin of the parent element.
> >
> > ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/Screenshot%202023-12-13%20at%2017.18.39.png)
> >
> > * **Display**: Choose **Linear** to arrange children with the Direction, Justify, Align, Wrap and Gap options below, or **Grid** to arrange them in columns. See [Grid layout](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/layout-configuration.md#grid-layout).
> >
> > * **Direction**: Choose between **Horizontal** or **Vertical** alignment to define the flow of components. For example, select Horizontal for a left-to-right layout.
> >
> > * **Justify**: Aligns children along the main axis (horizontal when Direction is Horizontal, vertical when it is Vertical). Options: start, center, end, space between, space around, and space evenly. On iOS and Android: start, center, and end.
> >
> > * **Align**: Aligns children along the cross axis. Options: start, center, end, and stretch. On iOS and Android: start, center, and end.
> >
> > - **Wrap**: Enable wrapping to automatically move items to the next line when they reach the end of the container. Useful for creating multi-line layouts.
> > - **Gap**: Define the space between components to control the distance between each item. Adjusting the gap enhances visual clarity and organization.
>
> > [tab] Sizing
> >
> > Adjusting the size of components is crucial for a responsive design. Fit W (width) offers three options:
> >
> > * **Fill**: Fills the available space.
> > * **Fixed**: Maintains a fixed width.
> > * **Auto**: Adjusts the width automatically based on content.
> >
> > Fit H (height) offers two options:
> >
> > * **Fixed**: Sets an exact height in pixels. Content that doesn't fit scrolls inside the container.
> > * **Auto**: Adjusts the height automatically based on content.
> >
> > Fit H has no **Fill** option, so a container can't stretch to the full height of the page. To make it taller, set Fit H to **Fixed** and enter the height you need.

> [tab] iOS
>
> Similar styling considerations apply to iOS as for web.
>
> However, there are exceptions, particularly with **Sticky layout**:
>
> ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/sticky_mobile.png)
>
> In mobile configurations, the right and left properties for **Sticky layout** are ignored by the iOS renderer.
>
> **Scrollable**: In the **Layout** section, turn off **Scrollable** to stop the screen from scrolling. **Default:** on. The toggle appears only on the root container of a user task, or on a container placed directly in a UI Flow navigation area.

> [tab] Android
>
> Similar styling considerations apply to Android as for web.
>
> However, there are exceptions, particularly with **Sticky layout**:
>
> ![Sticky layout left and right properties on a mobile platform tab](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/sticky_mobile.png)
>
> In mobile configurations, the right and left properties for **Sticky layout** are ignored by the Android renderer.
>
> **Scrollable**: In the **Layout** section, turn off **Scrollable** to stop the screen from scrolling. **Default:** on. The toggle appears only on the root container of a user task, or on a container placed directly in a UI Flow navigation area.

### Theme overrides

Customize the appearance by overriding style options coming from your default theme. Available overrides:

* Border Width
* Border Radius
* Border Color
* Background Color
* Shadow

More layout demos available below:

> [card] [Layout Demos](https://tburleson-layouts-demos.firebaseapp.com/#/docs)

For more information about styling and layout configuration, check the following section:

> [card] [UI Designer](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/ui-designer.md#styles-tab)


## Related topics

- [Container app branding](https://docs.flowx.ai/6.x/docs/saas/container-app-branding.md)
- [Container app authentication](https://docs.flowx.ai/6.x/docs/saas/container-app-authentication.md)
- [Root Components in UI Design](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/ui-component-types/root-components/root-components.md)
- [Organization branding](https://docs.flowx.ai/6.x/docs/saas/organization-branding.md)
- [FlowX.AI 5.6.0 Release Notes](https://docs.flowx.ai/release-notes/v5.x/v5.6.0-march-2026/v5.6.0-march-2026.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.