Skip to main content

Image Input mobile component

Take a photo with the camera or select photos from the library.

An input field to capture images from the device's camera or photo library. Image Input supports taking or selecting multiple photos, minimum and maximum count, and quality adjustments.

Captured images are temporarily stored on the device for native apps and in the Retool organization for web apps.

Image Input

Properties

cameraOpened
boolean

Whether the camera is currently in use.

disabled
boolean

Whether user input, interaction, or selection is disabled.

files
object[]

The metadata from the selected files. Includes name, type, size, and last modified..

hidden
boolean

Whether the component is visible.

id
string

The name of the component.

label
string

The input label.

launchMode
'camera' │ 'library' │ 'option'

Whether to capture images from the camera, photo library, or enable the user to select.

libraryOpened
boolean

Whether the photo library is currently open.

maxCount
number | null

The maximum number of items allowed.

minCount
number | null

The minimum number of items allowed.

placeholder
string

The placeholder text for the input.

pluginType
string

The component type.

resolution
'original' | 'high' | 'medium' | 'low'

The resolution with which to optimize captured images.

selectionType
'single' │ 'multiple' │ 'directory'

The type of selection to allow.

shouldCompress
boolean

Whether to compress captured images.

tooltipText
boolean

The text to display in a tooltip on hover or focus.

value
string[]

A list of blob: or file:// URI strings. Use utils.getDataByObjectURL() to convert into Base64-encoded strings.