Fluent Commerce Logo
Docs

Application Switcher Component

UI ComponentUI Component overview

Changed on:

15 May 2026

Overview

The Application Switcher is an interactive component used for navigation between applications.It enables users to switch between available applications (for example, OMS, Store, Inventory, Analytics Studio) based on their roles and active context.Application visibility is driven by the `fc.mystique.apps` setting, which defines the list of applications and the required role and context conditions for each.The component is displayed only when multiple applications are available to the user.
Plugin NameCore
The standard library of mystique components. 

Alias

Detailed technical description

The Application Switcher renders the list of available applications based on the configuration defined in the `fc.mystique.apps` setting.For each application:
  • The component reads the application definition (`name`, `label`, `context`)
  • The user’s roles are evaluated against:
    • the required `context.role`
    • the specified `context.level`
  • The application is displayed only if the user satisfies the role requirement at the given context level
If more than one application is available after evaluation, the switcher is rendered in the UI and allows navigation between applications.The `name` field is used to resolve the target application, while the `label` is used for display via internationalization.The Application Switcher controls access to application entry points only. It does not:
  • manage application authorization
  • control page-level routing
  • filter application data
  • replace backend permission validation
Application filtering rules are documented in the `fc.mystique.apps` setting.
Behaviour
  • Displays only applications accessible to the current user
  • Updates dynamically based on active context (for example, switching retailer or location)
  • Displays translated application labels using configured i18n keys
  • Navigates users to configured application entry points
  • Hidden when:
    • no applications are configured
    • no applications are accessible
    • only one application is available

Properties

[Warning: empty required content area]

Version History

Recommended Placement

[Warning: empty required content area]