FIELDS

Image choices field

Create visual choice cards in Logical Forms, choose one or multiple answers, add Media Library images and configure labels, sizes and limits.

3 min read · Updated November 19, 2026

Use Image choices when pictures help visitors distinguish alternatives, such as a preferred design style or product category. It is a separate Core field, rather than an image mode on ordinary Radio buttons or Checkboxes.

Availability: Core (Free).

Add and configure the field

  1. Open the form in Build and add Image choices from Add fields.
  2. Select its canvas card to open Field options, then configure the controls below.
  3. Save the form and check its saved Preview and embedded page.

Field-specific settings

Setting What it does
Selection Select one is the default and uses radio-style selection. Select multiple allows several cards and reveals selection-count limits.
Choices Manage each label, stable saved value and optional Media Library image. Use the image control to choose, replace or remove an attachment; a card can also have no image.
Default choices Choose the initial card or cards. Single mode permits at most one. Switching the builder to single retains the first default; it does not rewrite historical entries.
Show clear selection When enabled on an optional field, offers Clear selection while a choice is selected. Required fields suppress it. The control needs JavaScript.
Show choice labels On by default. Turning it off visually hides labels only where an image exists; accessible labels remain. A card with no image keeps visible text.
Card size Small, Medium or Large responsive card sizing. This changes card presentation, not the original image file or a new physical upload size.
Minimum selections Optional whole-number minimum when choices are selected. Enable Required separately to reject an empty answer.
Maximum selections Optional whole-number maximum. Answers above the limit are rejected, not truncated. Set the same minimum and maximum to require an exact count, alongside Required.

Applicable shared options

This field also provides Description placement, Validation message placement, Label, Description, Required, Required message, Invalid value message, CSS classes, Hide label, Admin label, Visibility. See common field options for their behavior.

Review Visible, Hidden and Internal before changing presentation. Static hiding differs from conditional applicability.

Dynamic population offers Disabled, Parameter, Current user. Its applicable Parameter name and User property controls select the initial source; submitted or cleared answers are not refilled.

Answers and behavior

The saved answer is always a list of values, even in Select one mode. Images remain choice configuration; the entry does not store a snapshot of the artwork. Entries and ordinary notifications show readable current choice labels rather than automatically embedding the pictures.

Single mode ignores retained multiple-mode bounds and hides that count configuration. Clear selection applies only to optional single-selection mode. A deleted or missing image falls back to a text card instead of silently deleting its choice.

Choice images use the Media Library, not a visitor file-upload control. Labels remain required to identify cards accessibly, even when visually hidden.

Example and checks

For Preferred style, create three clearly named cards such as Minimal, Editorial and Bold. Give each a stable value, select its image and start with Show choice labels enabled. Keep Select one unless several preferences are useful.

Test keyboard focus, selection, an optional clear, and a missing-image/text-only card. If using multiple mode, test the selection limits. Check that the saved labels and values still communicate the answer without its artwork.

Use the testing checklist to check validation and the saved entry. Explore all fields provides live examples.