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

# FlowX.AI 5.9.1 Release Notes (LTS)

> Maintenance release for the 5.9.x LTS line. Bug fixes, security patches, and stability improvements, including split AI permissions, the legacy script flag, and File Storage and document-preview fixes.

<Info>
  This is a **Long-Term Support (LTS)** maintenance release in the **5.9.x** line, focused on **bug fixes**, **security patches**, and **stability improvements**. Upgrades from **5.9.0 → 5.9.1** are non-breaking and fully compatible.
</Info>

<Card title="Release Highlight" icon="star" iconType="duotone">
  **FlowX.AI 5.9.1** is a maintenance release for the 5.9.x LTS with bug fixes, security patches, and a few targeted improvements:

  * **Import/export:** stability and cross-version compatibility fixes
  * **Split AI permissions:** separate governance for AI runtime usage and AI build-time tooling
  * **Legacy script flag:** per-rule Native / GraalVM script runtime selection
  * **File Storage and document-preview improvements**
  * Wide set of Designer, Renderer, and platform bug fixes
  * No breaking changes; fully compatible upgrade from 5.9.0
</Card>

***

**What's new? 🆕**

<Tabs>
  <Tab title="Highlights">
    Bug fixes and stability improvements across the platform, with a few targeted enhancements in the 5.9.x LTS line.

    🔐 [**Split AI permissions**](#split-ai-permissions) - Independent governance for AI usage and AI build tooling.\
    📝 [**Legacy script flag**](#legacy-script-flag) - Per-rule Native / GraalVM script runtime selection.\
    🗂️ [**File Storage improvements**](#file-storage-improvements) - FTP connection and preview fixes.\
    📄 [**File Preview scroll events**](#file-preview-scroll-events) - Scroll-trigger event handlers for the File Preview component.\
    🔧 [**Platform improvements**](#platform-improvements) - Designer, Renderer, Workflows, and backend bug fixes plus security patches.

    ***

    ### **Split AI permissions**

    <Card title="Separate governance for AI usage and AI build tooling" icon="shield-halved" iconType="duotone">
      <Tabs>
        <Tab title="Overview">
          AI permissions are now split into two independent controls, so administrators can govern **AI runtime usage** separately from **AI build-time tooling** (AI Designer, agent building, code generation).
        </Tab>

        <Tab title="Behavior">
          * When AI is turned off, AI-related icons and entry points are hidden rather than shown in a disabled state.
          * AI nodes in workflows behave consistently with the gateway's availability.
          * Build-time AI helpers (code generation, "Add comment") follow the dev-agent permission rather than the runtime AI permission.
        </Tab>
      </Tabs>

      <Badge color="green" icon="globe">All Deployments</Badge>
    </Card>

    ***

    ### **Legacy script flag**

    <Card title="Per-rule Native / GraalVM script runtime" icon="code" iconType="duotone">
      Business rules, reusable functions, and node rules can now choose their script engine individually: the current **native** engine (the 5.9 default) or the legacy **GraalVM** engine. Rules created before the switch to native keep running on GraalVM until you migrate them, while new rules default to native, so teams can move scripts across at their own pace. The per-rule selector only appears for rules that support GraalVM; new rules run on native.
      <Badge color="green" icon="globe">All Deployments</Badge>
    </Card>

    ***

    ### **File Storage improvements**

    <Card title="FTP connection and preview fixes" icon="folder-tree" iconType="duotone">
      * FTP **test connection** now resolves configuration-parameter placeholders before connecting.
      * **File operations** also resolve configuration-parameter placeholders at runtime.
      * FTP **file preview** works when the root path has no leading slash.
        <Badge color="green" icon="globe">All Deployments</Badge>
    </Card>

    ***

    ### **File Preview scroll events**

    <Card title="Scroll-trigger event handlers for File Preview" icon="file-magnifying-glass" iconType="duotone">
      The **File Preview** component now supports **scroll-trigger event handlers** (including a "document end" trigger), configurable in the Designer and handled by the web, iOS, and Android renderers. They let a flow detect when a user scrolls through a document or reaches its end.

      This is built for consent and disclosure use cases such as banking flows that must prove, per local regulation, that the user actually read an agreement. You can keep an action such as a **Submit** or **Accept** button hidden or disabled until the document-end event handler fires; that handler can be a simple local script that sets a flag to enable the button.
      <Badge color="green" icon="globe">All Deployments</Badge>
    </Card>

    ***

    ### **Platform improvements**

    <Card title="Platform Improvements" icon="wrench" iconType="duotone">
      <Tabs>
        <Tab title="Designer & Renderer">
          <Accordion title="Designer fixes">
            * **Forms to validate:** fixed scrolling through the full component hierarchy, placeholder updates, and incorrect selection of chat and tab-bar components.
            * **Process instances:** fixed a browser crash when loading instances with very large execution graphs.
            * **Theme admin:** fixed theme content being lost when using "copy to".
            * **UI Flow:** fixed images not displaying in preview after refresh, and a missing theme UUID when returning from an expired UI Flow.
            * **Actions:** stopped GET actions firing with undefined parameters.
            * **Modals:** fixed dropdown flicker and layout issues with long key names.
          </Accordion>

          <Accordion title="Renderer fixes (Web / React / React Native)">
            * **Web:** fixed missing button shadow, modal content padding, and rendering when a media-file storage path is null.
            * **File Preview:** fixed preview not rendering correctly, events not firing inside collections, fixed height not applied at runtime, and CORS errors when accessing preview resources.
            * **React Native:** fixed date-picker shifting to a previous day and input/textarea retaining focus after moving to another component.
            * **Task management:** fixed header theming (React/Angular) and the filter window disappearing after applying criteria.
            * **File upload:** the upload button now supports a configurable icon, set in the Designer and rendered on web, iOS, and Android.
          </Accordion>
        </Tab>

        <Tab title="Workflows & AI">
          <Accordion title="Workflow fixes">
            * Fixed END PARALLEL output including data from before the parallel branches started.
            * Optimized storage of running steps for workflows.
            * Fixed a crash in NoSQL node run logs when a node failed before building its options.
            * Workflows and processes launched from a UI Flow now inherit the build from the parent UI Flow.
            * AI node failures now surface the error details and model reasoning in the workflow run logs, making failed AI steps easier to diagnose.
          </Accordion>

          <Accordion title="AI improvements & fixes">
            * **AI Designer** generates more reliable UI from a flat template format (replacing the previous 3-level nesting), supports additional component types (including Multi-Select, Bulk File Upload, Table Cell, and Collection), edits existing templates by applying changes incrementally instead of regenerating from scratch, and can now generate **reusable UI templates**.
            * Fixed agent responses reappearing in chat after stop and refresh.
            * Fixed duplicated messages in the builder-agent chat.
            * **Knowledge Base:** files that fail to upload because the content is too large no longer appear in the content source list.
            * **Platform Status** now reports AI Platform components and their databases alongside the core services.
          </Accordion>
        </Tab>

        <Tab title="Platform & Backend">
          <Accordion title="Backend fixes">
            * Fixed a null value being wrongly cached when looking up the "All end-users" group, which could block logins until data-sync completed.
            * Fixed copying a process or workflow to another project: the copy now succeeds, and copied workflows appear in the target project.
            * Fixed an invited Designer user added as an Organization owner not being assigned to a workspace.
            * Improved merge-conflict handling for custom components and UI Flows, with clearer resource identification.
            * Hide/disable conditions on UI templates, processes, and UI Flows are now applied at runtime for Designer users without workspace access.
            * Fixed a 500 (duplicate key) error when activating a start timer event after a new build regenerated the process resource ID.
            * Fixed a 500 error when opening a Usage Overview.
            * Organization settings navigation and design improvements.
            * **Runtime config params:** changes to runtime configuration parameters now propagate to the process engine in near-real-time, so updated values take effect immediately instead of after a short cache delay.
            * **Microsoft Outlook connections** now support certificate-based authentication for Microsoft Graph, as an alternative to client-secret credentials.
          </Accordion>

          <Accordion title="Security patches & dependency upgrades">
            This release includes security patches and dependency upgrades across platform components.
          </Accordion>
        </Tab>
      </Tabs>
    </Card>

    ***
  </Tab>

  <Tab title="Info">
    ## Additional information

    <Info>
      **Upgrade Compatibility**: FlowX.AI 5.9.1 is fully compatible with 5.9.0. No breaking changes; standard deployment procedures apply.
    </Info>

    ### Compatibility

    <CardGroup cols={2}>
      <Card title="Upgrade Path" icon="arrow-up-right-dots">
        Direct upgrade from 5.9.0 → 5.9.1 with no breaking changes. Self-hosted customers on 5.1.x LTS upgrade directly to the 5.9.x line; see [Migrating from 5.1 LTS](/5.9/migrating-from-5.1-lts/overview).
      </Card>

      <Card title="Component Compatibility" icon="circle-check">
        Compatible with FlowX.AI SDKs (Angular/React/iOS/Android), Designer, and Database 5.9.x.
      </Card>
    </CardGroup>

    ### Deployment information

    <Info>
      Component versions for 5.9.1 are tracked in the [5.9.1 deployment guidelines](./deployment-guidelines-v5.9.1). {/* TODO: confirm pins via `fx versions 5.9.1` once the tag is cut */}
    </Info>

    ### What's next

    **FlowX.AI 5.9.x LTS** will continue to receive monthly maintenance updates focused on:

    * Security patches and vulnerability fixes
    * Stability improvements and bug fixes
  </Tab>
</Tabs>


## Related topics

- [FlowX.AI 5.1.9 Release Notes (LTS)](/release-notes/v5.x/v5.1.x-lts/v5.1.9-may-2026.md)
- [FlowX.AI 5.1.5 Release Notes (LTS)](/release-notes/v5.x/v5.1.x-lts/v5.1.5-february-2026.md)
- [FlowX.AI 5.1.7 Release Notes (LTS)](/release-notes/v5.x/v5.1.x-lts/v5.1.7-march-2026.md)
- [FlowX.AI 5.1.8 Release Notes (LTS)](/release-notes/v5.x/v5.1.x-lts/v5.1.8-april-2026.md)
- [FlowX.AI 5.1.1 Release Notes (LTS)](/release-notes/v5.x/v5.1.x-lts/v5.1.1-november-2025.md)