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.

Custom colors

Set primary, secondary, header, and page background colors

Logo upload

Replace the default logo with your organization’s branding

Header control

Show or hide the container app header (useful for iframe embeds)

Live preview

Preview branding changes before saving

---

Accessing branding settings

To configure branding:

1. Navigate to Organization Admin in FlowX Designer
2. Select Generic App Branding under Design Assets

Branding settings require the org_branding_read permission to view and org_branding_edit permission to modify.

The branding page has a form panel on the left and a live preview on the right. Use the layout toggle in the header to switch between flat view, accordion view, or form-only mode.

---

Branding properties

General

Primary Color · hex color

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

Secondary Color · hex color

Used for avatar backgrounds and secondary accents.

---

Header

Show Header · boolean

Toggle the container app header on or off.

Default: ON

Turn off the header when embedding the container app in an iframe where the parent app provides its own navigation.

Logo · file upload

Custom logo displayed in the header. Replaces the default FlowX logo.

Supported formats: PNG, JPG, SVG, WEBP

Max file size: 2 MB

Background Color · hex color

Header background color.

Default: #2A313A

Shadow · preset

Header drop shadow. Choose from preset sizes or turn off completely.

Options: None, XS, S, M, L, XL

Each preset configures the shadow color, opacity, and blur radius.

---

Solutions page

Page Background Color · hex color

Background color of the solutions landing page where users select which solution to open.

---

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

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 the save. Reopen the branding settings in the Designer and verify the values (including the logo) were persisted and branding is turned on.

---

Related resources

Container app authentication

Configure authentication flows and session management for container apps

Organization settings

Manage organization-level configuration

FlowX SaaS overview

Understand the FlowX SaaS deployment model