Documentation
Visual Choices for Gravity Forms documentation
How to set up and use Visual Choices: install, settings and fixes for common problems.
Overview
Visual Choices turns the choices in Gravity Forms fields into image cards.
Where to find it: Forms → Settings → Visual Choices.
What you need
- WordPress 6.2 or newer
- PHP 7.4 or newer
- Gravity Forms 2.5 or newer
Install
- With The Vault (easiest): open The Vault in your WordPress menu, find Visual Choices and click Install. It is installed and activated for you.
- By hand: buy a license on the plugin page, then go to Plugins → Add New → Upload Plugin, choose the zip and activate it.
Updates arrive automatically from wpwizards.com, like plugins from WordPress.org.
License
This is a premium plugin. Open The Vault → Licenses, paste the key from your order confirmation and click Activate License. WP Wizards clients have every plugin included while their service is active, with no key needed. Without a license the plugin keeps working but stops receiving updates.
Quick start
- Turn it on for a field. Open a form, select a choice field and tick Show choices as images under the choices.
- Add the images. Click the image button beside each choice. Pick several images at once in the media library and they fill the choices in order.
- Set your defaults. Under Forms → Settings → Visual Choices, choose the style and columns used by every form unless a field picks its own.
Supported fields
Radio Buttons, Checkboxes, and Product, Option, Shipping, Poll, Survey and Quiz fields set to radio buttons or checkboxes. Real radio and checkbox inputs sit underneath, so conditional logic, calculations, product totals and screen readers work as normal.
Images in emails and entries
With the setting on, images appear in entry details, the entries list and {all_fields} emails. Any field merge tag also accepts :image (images with labels) or :image_url (image links).
Switching from Gravity Forms Image Choices
Fields already set up with Image Choices display with Visual Choices right away. Use Forms → Settings → Visual Choices → Import to bring them in so you can edit them here.
Settings
Defaults and field settings
| Style | Card, Tile (label over the image), Polaroid, Circle, Outline or Row (image beside the text). |
|---|---|
| Columns on desktop, tablet and phone | A number, or Auto fit. |
| Image shape | Square, 4:3, 3:2, Wide 16:9, Portrait 3:4, or Natural to keep each image’s shape. |
| Image fit | Fill the frame (crops the edges) or show the whole image. |
| Choice labels | Show or hide. Hidden labels are still read by screen readers. |
| Zoom button | Lets visitors view an image larger in a lightbox. |
| Highlight color | A hex color for the selected border and checkmark. Leave empty to use your Gravity Forms theme color. |
| Description and badge | Per choice: an optional description and a badge such as “Most popular”. |
| Minimum picks / Maximum picks | For checkbox fields. |
Troubleshooting and questions
Images do not show in my notification.
Turn on Show images in {all_fields} emails and entry details, or use the :image modifier on the field merge tag.
The columns look wrong on phones.
Set Columns on phone, or use Auto fit.
It says it needs Gravity Forms 2.5.
Install and activate Gravity Forms 2.5 or newer.
Get help
Stuck on something this page does not cover? Contact us and tell us which plugin and version you are on. Need it to do something it does not do yet? We build custom plugins too.
