Skip to main content

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.

Custom colors

Set the page, primary, secondary, header, and solution page colors

Logos

Replace the default FlowX logo with your organization’s logos

Header control

Show or hide the container app header (useful for iframe embeds) and set its size and shadow

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

Branding properties

Logos

Logos are set on the Brand foundations tab, as image URLs. See 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.
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.
hex color
Background color of the container app pages, such as the solutions page where users select which solution to open.Default: #F8FAFC
hex color
Accent color used for buttons, active states, and interactive elements on the solutions page.Default: #006BD8
hex color
Used for avatar backgrounds and secondary accents.Default: #FEB913

boolean
Toggle the container app header on or off. The other header settings appear only when the header is on.Default: ON
Turn off the header when embedding the container app in an iframe where the parent app provides its own navigation.
hex color
Header background color.Default: #2A313A
number (px)
Size of the header and the space around its content, in pixels. Leave a field empty to keep the default.
hex color
Color of the header shadow. The header has a shadow only when this color is set.
number
Opacity of the shadow, from 0 (transparent) to 1 (fully opaque).
number (px)
Blur radius of the shadow, in pixels.

Solution page

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.

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.
Branding is applied before authentication, so the login landing page also reflects the organization’s branding.

Troubleshooting

  • 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.

Container app authentication

Configure authentication flows and session management for container apps

Organization branding

Brand foundations, identity emails, and publishing

Organization settings

Manage organization-level configuration

FlowX SaaS overview

Understand the FlowX SaaS deployment model
Last modified on November 6, 2026