Skip to main content
These elements can be added to your interface using the UI Designer tool, and they are often used to convey information, enhance the aesthetic appeal of an interface, provide visual cues and feedback, support branding and marketing efforts, or present complex data or concepts in a more intuitive and accessible way.

Configuring an image

Configuring an image in the UI Designer involves specifying various settings and properties. Here are the key aspects of configuring an image:

Image settings

The image settings consist of the following properties: Depending on which Source Location is selected, different configurations are available:

Media library

  • Image Key - the key of the image from the media library
  • Select from Media Library - search for an item by key and select it from the media library
  • Upload to Media Library - add a new item (upload an image on the spot)
    • upload item - supported formats: PNG, JPG, GIF, SVG, WebP; ❗️(maximum size - 50 MB by default)
    • key - the key must be unique and cannot be changed afterwards

Process data

  • Identify the Source Type. It can be either a URL or Base 64.
  • Locate the data using the Process data key (Data key in a UI Flow). With URL, the value at that key is used as-is, so it must be a complete, absolute URL. The renderer attaches the user’s access token only when the URL ends in download. To show a file uploaded through the Documents plugin, build the URL from the upload reply’s downloadPath in a business rule, as shown in Preview an uploaded file.
  • In a UI Flow, where this location is labeled Local Variables, Source Type also offers Document plugin. Point the key to an object that contains downloadPath, such as an upload reply, and the renderer builds the URL.
  • Provide a Placeholder Url for public access. This is the URL where the image placeholder is available. The field is shown for every source location except Media Library.
SaaS · 5.13
Available on SaaS with FlowX.AI 5.13. This feature is live on managed (SaaS) deployments now. Self-hosted deployments will receive it with the next LTS release family.
On SaaS, Source in a process user task offers Media Library, Document Plugin Path, URL, and Base64. With Document Plugin Path, point the key at a Documents plugin downloadPath and the renderer builds the URL, so no business rule is needed. For how the shared file sources work, see File sources in FlowX.AI 5.13.

External

  • Source Type: it can be either a URL or Base 64
  • Image Source: the valid URL of the image.
  • Placeholder Url: the public URL where the image placeholder is available

Event handlers

The image supports the On Click trigger. In a process user task, the event handler offers Run Local Script, Node Action, Dismiss, Start Project, and External. A Node Action runs an action configured on the same node. In a UI Flow, the event handler offers Run Local Script, Start Process, Start Workflow, External, Navigate To, and Dismiss. For more information, see the Event Handlers documentation.

Expressions

  • Hide condition: hides the image when the expression evaluates to true. Set it in the Expressions section. The image has no Disabled condition.

Image settings overrides

You can override the image settings from the Generic tab for one platform (Web, iOS, or Android). Available override settings:
  • Properties:
    • Image source: override where the image is loaded from.
  • Expressions:
    • Hide: override the hide expression.

Accessibility

  • Mark as decorative: marks the image as decorative so assistive technologies ignore it. Turn it on for images that carry no information.
  • Alt text: a short text alternative that screen readers announce in place of the image. The field is unavailable while Mark as decorative is on.

Image styling

The image styling property allows you to add or to specify valid CSS properties for the image. For more information, see the styling documentation.

Theme overrides

You can override these style options from your theme for one platform (Web, iOS, or Android):
  • Border Color
  • Border Width
  • Border Radius
  • Shadow

Color

SaaS · 5.10
Available on SaaS with FlowX.AI 5.10. This feature is live on managed (SaaS) deployments now. Self-hosted deployments will receive it with the next LTS release family.
The image component has a Color property that applies a color to the image, useful for tinting single-color icons and SVGs so they match a theme without editing the source asset. To set it, open the component’s Styles tab, turn on Image color in the Properties section, and pick the Color. The web and Android renderers apply the color. SVG graphics are recolored while keeping their shapes. For other image formats, the color covers the entire image area.
Last modified on November 13, 2026