> ## 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 app branding

> Customize the visual appearance of the SaaS container app with organization-level branding settings.

## Overview

**Container app branding** lets organization administrators customize the visual appearance of the SaaS container app — the runtime that wraps FlowX solutions for end users. Branding settings apply organization-wide across all workspaces and projects.

> [card] Custom colors
>
> Set the page, primary, secondary, header, and solution page colors

> [card] Logos
>
> Replace the default FlowX logo with your organization's logos

> [card] Header control
>
> Show or hide the container app header (useful for iframe embeds) and set its size and shadow

> [card] Preview
>
> Preview branding changes before you publish them

***

## Accessing branding settings

To configure branding:

1. Open the avatar menu at the top right of FlowX Designer and select **Organization settings**.
2. Under **Customization**, select **Branding**.
3. Open the **Container app** tab.

> [!NOTE]
>
> Viewing the branding settings requires the `org_config_read` permission. Changing them requires `org_config_edit`.

The **Branding** page holds the branding for the whole organization: the container app, the login page, and identity emails. The settings for the container app are on the **Container app** tab, and the logos are on the **Brand foundations** tab. The **Preview** pane next to the form shows your changes before you save them. For the other tabs, see [Organization branding](https://docs.flowx.ai/6.x/docs/saas/organization-branding.md).

***

## Branding properties

### Logos

Logos are set on the **Brand foundations** tab, as image URLs. See [Logo set](https://docs.flowx.ai/6.x/docs/saas/organization-branding.md#logo-set).

The container app shows **Logo (dark)** in a header with a light background color and **Logo (light / inverse)** in a header with a dark one. If the matching logo isn't set, it uses the other one, and if neither is set, it shows the FlowX logo. It doesn't use **Mark / favicon**.

> [!WARNING]
>
> Once you change any color, or add a Terms of Service, Privacy Policy, or social link, both **Logo (dark)** and **Logo (light / inverse)** are required before you can save.

### Global colors

Colors accept a HEX value with 3 or 6 digits, for example `#FFF` or `#006BD8`.

**Page background** `hex color`

Background color of the container app pages, such as the solutions page where users select which solution to open.

**Default:** `#F8FAFC`

**Primary color** `hex color`

Accent color used for buttons, active states, and interactive elements on the solutions page.

**Default:** `#006BD8`

**Secondary color** `hex color`

Used for avatar backgrounds and secondary accents.

**Default:** `#FEB913`

***

### Header

**Show header** `boolean`

Toggle the container app header on or off. The other header settings appear only when the header is on.

**Default:** ON

> [!TIP]
>
> Turn off the header when embedding the container app in an iframe where the parent app provides its own navigation.

**Header background** `hex color`

Header background color.

**Default:** `#2A313A`

**Height, Padding top, Padding bottom, Padding left, Padding right** `number (px)`

Size of the header and the space around its content, in pixels. Leave a field empty to keep the default.

**Shadow color** `hex color`

Color of the header shadow. The header has a shadow only when this color is set.

**Opacity** `number`

Opacity of the shadow, from `0` (transparent) to `1` (fully opaque).

**Blur** `number (px)`

Blur radius of the shadow, in pixels.

***

### Solution page

**Background color** `hex color`

Background color behind an open solution. It applies to all solutions. Leave it empty to keep the default.

***

## Saving and publishing

Saving the branding doesn't publish it. To publish, turn on the **Enabled** toggle at the top of the **Branding** page. The toggle and **Reset to FlowX default** cover all of the organization's branding, not only the container app. See [Save and publish](https://docs.flowx.ai/6.x/docs/saas/organization-branding.md#save-and-publish).

***

## How branding is applied

When an end user loads the container app:

1. The app resolves the organization context (from the hostname or organization code)
2. Branding configuration is included in the organization lookup API response
3. The container app applies branding values as CSS custom properties
4. Colors, logo, and header settings apply as soon as the app loads

Because branding travels with the organization lookup at app load, changes saved in the Designer reach end users the next time the container app loads. An already-open app keeps the branding it fetched at startup until it is reloaded.

> [!NOTE]
>
> Branding is applied before authentication, so the login landing page also reflects the organization's branding.

### Troubleshooting

> [accordion] Branding changes don't show up in the container app
>
> * **Reload the app fully.** Branding is fetched with the organization lookup when the app loads, so refresh the browser tab (or restart the mobile app) after saving changes.
> * **Check the organization.** The app resolves branding from the hostname or organization code it was opened with — confirm it matches the organization where you edited the branding settings.
> * **Confirm it's published.** Reopen the branding settings in the Designer and check that the status is **Live**. **Saved, not live yet** means the branding is saved but the **Enabled** toggle is off.

***

## Related resources

> [card] [Container app authentication](https://docs.flowx.ai/6.x/docs/saas/container-app-authentication.md)
>
> Configure authentication flows and session management for container apps

> [card] [Organization branding](https://docs.flowx.ai/6.x/docs/saas/organization-branding.md)
>
> Brand foundations, identity emails, and publishing

> [card] [Organization settings](https://docs.flowx.ai/6.x/docs/saas/organization-settings.md)
>
> Manage organization-level configuration

> [card] [FlowX SaaS overview](https://docs.flowx.ai/6.x/docs/saas/saas-overview.md)
>
> Understand the FlowX SaaS deployment model


## Related topics

- [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)
- [Container app authentication](https://docs.flowx.ai/6.x/docs/saas/container-app-authentication.md)
- [Organization branding](https://docs.flowx.ai/6.x/docs/saas/organization-branding.md)
- [Organization settings](https://docs.flowx.ai/6.x/docs/saas/organization-settings.md)
- [Runtime authorization](https://docs.flowx.ai/6.x/setup-guides/access-management/runtime-authorization.md)


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