🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Image Hotspot Field Premium Add-on Setup Guide

Updated 11 min read Gravity Forms Fields & Inputs
On this page
  1. Video walkthrough
  2. Requirements
  3. Install and activate
  4. Add the field to a form
  5. Choose the picture and draw the areas
  6. 1. Pick the picture
  7. 2. Draw and edit areas
  8. 3. Name the areas
  9. What visitors see
  10. Keyboard and screen reader use
  11. Pin mode
  12. Validation
  13. Entries, export and the entry list
  14. Merge tags and notifications
  15. Conditional logic
  16. Prices and totals
  17. Multi-page forms, Save and Continue and AJAX
  18. Settings of the add-on
  19. Privacy and security
  20. Troubleshooting
  21. Changelog

Video walkthrough

Gravity Forms Image Hotspot Field: Let Visitors Click Parts of a Picture, with Prices
Watch the Image Hotspot Field let visitors click the parts of a picture, add each part’s price to the total and show the marked picture in the entry. Watch on YouTube

The Gravity Forms Image Hotspot Field Premium Add-on adds a new field to Gravity Forms: a picture that visitors click. Instead of describing where it hurts, which part of the car is dented, which room needs work or which seat they want, the visitor points at it. The field works with a drawing of your own, a photo from the Media Library or one of the starter templates, and it behaves like any other Gravity Forms field: it can be required, it takes part in conditional logic, it can add to the order total, and its answer is available in entries, exports and notifications.

A Gravity Forms form with an Image Hotspot field: a front view of a human body where the chest and one upper arm are highlighted and a tooltip names the area under the pointer
A body picture with two areas selected and a tooltip. Every area can also be reached with the keyboard.

The field has two ways to answer. In area mode you draw areas on the picture and the visitor selects one or more of them. In pin mode the visitor drops numbered pins anywhere on the picture and can write a short note for each one, which suits damage reports and any form where the exact spot matters more than a fixed list of areas.

Requirements

  • WordPress 6.5 or newer and PHP 7.4 or newer.
  • Gravity Forms 2.9 or newer. The add-on is tested on Gravity Forms 3.1.2 with PHP 8.3 and on Gravity Forms 2.9.8 with PHP 7.4.
  • The PHP DOM extension, which almost every host has, for importing and cleaning SVG drawings. Without it you can still use pictures from the Media Library and areas you draw.
  • An active Gravity Extra license key. Without one, visitors see a plain list of the areas instead of the picture, so a form never breaks.

The add-on is standalone. It contacts no outside service and uses no third-party picture or script. The starter drawings are shipped with the add-on.

Install and activate

  1. Upload the add-on in Plugins → Add New → Upload Plugin and activate it. Gravity Forms must be active first.
  2. Open Forms → Settings → Image Hotspot Field, paste your license key and activate it.
  3. On the same screen you can choose the default highlight colour and whether area names are shown in a tooltip or always on the picture.

Add the field to a form

Open a form in the form editor. In the field picker, under Advanced Fields, add Image Hotspot. Select the field and look at its settings on the left or right of the editor, depending on your Gravity Forms version.

  • How visitors answer: click areas of the image, or drop numbered pins anywhere.
  • Choice (area mode): multiple areas, or one area only. With one area, a second click replaces the first.
  • Maximum areas and Minimum: stop a visitor from choosing more than a number of areas, or ask for at least a number. Zero means no limit.
  • Maximum pins and notes (pin mode): up to 100 pins, with or without a note box for each pin.
  • Image description for screen readers: the text a screen reader announces for the picture, for example A front view of a human body.
  • Highlight colour: a hex colour for this field only. Empty uses the default from the add-on settings.
  • The usual field settings still apply: label, description, required, error message, CSS class, visibility and conditional logic.

Choose the picture and draw the areas

Press Edit image and areas. A large drawing screen opens on top of the form editor.

The Image and areas screen of the form editor: a car top view with drawn areas, the Hood selected with drag handles, and the label, value and price boxes of each area on the right
The drawing screen with the car template. The selected area shows its drag handles.

1. Pick the picture

  • Choose from Media Library opens the normal WordPress media window. Any picture works; the add-on reads its size so the areas stay in the right place at every screen width.
  • Start from a template puts a ready drawing and its areas on the canvas: human body front, human body back, car top view, a floor plan with seven rooms, and a seat map with thirty seats. They are simple drawings made for this add-on, so you can change every area or replace the picture.
  • Import SVG reads an SVG file from your computer. Every rectangle, circle, ellipse, polygon, polyline or path that has an id becomes an area, named from its id (left-door becomes Left door). Shapes with generated ids such as path4821, and all shapes without an id, stay in the background. Group transforms and the view box of the file are taken into account, so the areas sit exactly on the drawing.

2. Draw and edit areas

  • Pick Rectangle or Circle and drag on the picture. Pick Polygon, click each corner, then double-click, press Enter or click the first corner to finish.
  • With Select and move, click an area to select it. Drag its body to move it. Drag the round handles to resize a rectangle, change the radius of a circle or move a corner of a polygon. Double-click a polygon edge to add a corner.
  • Arrow keys move the selected area by one unit, with Shift by ten. Delete removes it. Escape cancels a polygon you are drawing.

3. Name the areas

Each area has a label (shown to visitors and in entries), a value (stored with the entry and used by conditional logic and merge tags) and an optional price. The value follows the label until you edit it yourself. Values must be unique; the add-on adds a number when two areas would share one. Press Done to put the drawing in the field. The form is saved with the normal Save Form button.

In pin mode only the picture is needed. The drawing screen then shows the picture without the drawing tools.

What visitors see

  • The picture scales to the width of the form and keeps its proportions, from a wide desktop to a phone.
  • Hovering over an area shows its name in a tooltip. On a touch screen a tap selects the area and briefly shows the name.
  • A click or tap toggles the area. Selected areas are filled with the highlight colour.
  • With a maximum, the add-on stops further selections and says so in a message that screen readers announce.
  • If the form is shown again after an error, or restored from a saved link, the same areas are selected.

Keyboard and screen reader use

Every area is a real, focusable control. Press Tab to move through the areas in the order you drew them, and press Space or Enter to select or clear one. Each area has an ARIA label with its name (and price when it has one), a role of checkbox, or radio when only one area may be chosen, and an aria-checked state. A live region announces what was selected or cleared, and when a limit stops a choice.

For screen readers there is also a list of all areas as ordinary check boxes (or radio buttons) that is kept in step with the picture. It is hidden from sight and left out of the Tab order, so keyboard users do not meet each area twice, while screen reader users can reach it in browse mode. The picture itself has the description you wrote in the field settings.

Pin mode

In pin mode the visitor clicks or taps the picture to drop a pin. The pin gets the next number and its position is stored as percentages of the picture width and height, so it stays right whatever the screen size. Pins can be dragged to a better spot. Each pin has an optional note of up to 200 characters.

  • Add pin drops a pin near the middle, which is the keyboard way to place one. With a pin focused, the arrow keys move it by one percent, with Shift by five percent. Delete removes it.
  • Remove all pins clears the picture.
  • The maximum number of pins is enforced in the browser and again on the server.

Validation

Validation runs on the server, so it cannot be skipped. A required field needs at least one area or pin. The minimum and maximum are checked, a single-choice field refuses more than one area, and a value that is not one of the areas of the field is refused. The messages are ready to read, and the usual custom error message of Gravity Forms replaces the required message when you set one.

Entries, export and the entry list

The entry stores a short list. In area mode it is the list of chosen values; in pin mode it is the list of pins with their percent coordinates and notes. The entry screen turns that into a picture and a list.

A Gravity Forms entry screen showing the body picture with the chest and the right knee highlighted, and the two area names listed under the picture
The entry screen shows the picture with the chosen areas highlighted and the area names below it.
  • The entries list shows the area names (or the pins) in one cell.
  • Export writes one column for the field: the values, or the labels when you export labels. Pins are written as text such as Pin 1 (30%, 40%): note.
  • Entries keep working if you later change the picture, because the stored value is the area value, not a position.

Merge tags and notifications

Use the field merge tag as it is, for example the tag for the field with id 4, to get the area names separated by commas. Add a modifier after the field id:

  • values: the stored values instead of the labels.
  • list: a bullet list in an HTML notification.
  • count: how many areas or pins were chosen, as a number.
  • price: the total of the prices of the chosen areas, as a number, which is what a calculation field needs.
  • image: the marked picture in an HTML notification, followed by the list. The picture is a small inline SVG with the chosen areas highlighted or the pins drawn. Some mail programs do not display inline pictures of this kind, so the list under the picture is always there. In a plain text notification you get the list only.

The all fields tag shows the list in notifications and the picture with the list on the entry screen.

Conditional logic

The field can be the source of a rule, and the rule can use the values of the areas: show a Bathroom problem field when the Bathroom area is chosen, hide a question when a certain area is not chosen. The rule works in the browser as the visitor clicks, and the same rule is applied again on the server, so a hidden field is never saved. The field can also be the target of a rule like any other field.

Prices and totals

Give an area a price in the drawing screen and a chosen area adds that price to the order. This is how a seat map, a list of extras on a vehicle or a menu of parts can be priced. The pieces are:

  • Add a Total field. It shows the sum of the products and the chosen areas while the visitor clicks, in your currency format.
  • Gravity Forms needs at least one Product field in the form for its live total. A Single Product with the price zero is enough when you have no base price.
  • On the server the chosen areas become lines of the order with their label and price, so payment add-ons, the order summary and the entry total use them. Areas in a field that is hidden by conditional logic are not charged.
  • In a Number field with a calculation you can write the merge tag of the field in the formula, for example the field tag multiplied by two. The add-on replaces it with the total of the chosen prices, live in the browser and again on the server. Pin mode has no prices.

Multi-page forms, Save and Continue and AJAX

The field works on any page of a multi-page form. The selection is kept when the visitor goes Next and Back, and is saved with the entry at the end. With Save and Continue, the chosen areas or pins are stored in the saved form and are selected again when the visitor returns with the link. Forms embedded with AJAX enabled work without a page reload.

Settings of the add-on

  • Highlight colour: the default for selected areas, pins and the entry picture.
  • Tooltip: show the area name on hover and focus.
  • Names on the image: always show the area names on the picture, useful for small drawings with few areas.
  • Requirements and status: shows your Gravity Forms version, whether the PHP DOM extension is present and whether the license is active.

Privacy and security

The add-on sends nothing to anyone. The picture is read from your own site. SVG drawings are cleaned every time they are used: only drawing shapes and plain presentation attributes are kept, and scripts, event handlers, links, images, style sheets and external references are removed, so a drawing can only draw. Area labels and pin notes are stored as plain text. Pin positions and notes are personal data only if your visitors write personal data in them, so treat them like any other free text field in your privacy policy.

Troubleshooting

  • Visitors see a plain list and no picture. The license is not active. Activate it under Forms → Settings → Image Hotspot Field.
  • The picture does not show. Open the drawing screen and check that an image, a template or an SVG is set. A picture from the Media Library must still exist.
  • The picture is not shown in the e-mail. Some mail programs hide inline SVG. The list under the picture is still in the mail.
  • The Total does not follow the clicks. The form needs a Product field and a Total field, as described under Prices and totals.
  • An imported SVG has no areas. Only shapes with a meaningful id become areas. Give your shapes ids such as left-door in your drawing program.

Changelog

1.0.0 (October 22, 2026): first release with area mode and pin mode, the drawing screen, SVG import, five templates, keyboard and screen reader support, merge tags, conditional logic, prices and calculations, entry picture, export, multi-page and Save and Continue.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr