Backgrounds

Set a background on any screen with the Fill panel under Screen settings. Each layer in the panel is a solid color, gradient, image, or video, and a screen can stack several of them — which is how you tint an image or a video.

Image

Flow builder background image

Upload a .JPG, .PNG, or .WEBP file up to 20 MB. The image scales to cover the entire background.

Note

Background images and videos fill the entire viewport, including areas behind the notch and system bars — even when Safe area is enabled. Keep important content away from the edges to avoid clipping.

To swap the background image at runtime from your app code, enable a custom media ID.

Video

Flow builder background video

Upload an .MP4 or .WEBM file up to 50 MB. The preview shows a still frame — but the video plays on device at runtime.

Toggle Loop to replay the video continuously.

To swap the background video at runtime, enable a custom media ID.

Solid color

Flow builder solid background

Enter a six-digit hex value, such as #FFFFFF, and set opacity from 0 to 100%. A shorter value blocks publishing. Pick a saved color style from the swatch to apply your brand color — the background follows your light and dark themes automatically.

Gradient

Flow builder gradient background

Build a multi-stop linear gradient:

  • Direction — rotate the gradient from 0 to 360°.
  • Stops — drag along the bar to reposition. Click a stop to edit its six-digit hex value and opacity.
  • Opacity — the slider on the layer’s row scales every stop at once, so the fade between them stays intact.
Configuring a gradient fill with multiple color stops

Tint a background

Copy set over an image or a video is legible only where the media behind it happens to be dark enough. To even out that surface, stack a semi-transparent layer over the media:

  1. In Screen settings, set the Fill layer to your image or video.
  2. To add a second layer, click next to Fill. The new layer appears at the top of the list and paints over the media.
  3. Click the layer’s swatch and select Gradient . To darken only the edge that carries your copy, run the gradient from an opaque stop at that edge to a transparent stop at the other.
  4. To set the strength of the tint, drag the slider on the layer’s row.

Drag a layer to move it in the stack, and click to remove it.

A gradient tint layer at 67% over an image layer in the Fill list