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

Gravity Forms Inspection Checklist Setup Guide

Updated 10 min read Gravity Forms Integrations A–Z
On this page
  1. Video walkthrough
  2. What you need
  3. Install and activate
  4. Build the checklist
  5. Item options
  6. Paste a list
  7. Templates
  8. Score and result
  9. Labels and photos
  10. Run an inspection on a phone
  11. What the server checks
  12. The entry report
  13. Merge tags for e-mails and confirmations
  14. Conditional logic
  15. Export
  16. How it differs from other tools
  17. Privacy and storage
  18. FAQ
  19. Does the inspector need an internet connection?
  20. Can I change the checklist after inspections were recorded?
  21. Can I use more than one checklist in a form?
  22. What does uninstalling remove?

Video walkthrough

Gravity Forms Inspection Checklist Setup Guide: Pass/Fail Items, Photos & Scores
Video setup guide: Gravity Forms Inspection Checklist Watch on YouTube

The Gravity Forms Inspection Checklist add-on adds one new field to Gravity Forms: an inspection checklist that an inspector works through on a phone. You build the checklist in sections and items, each item is answered Pass, Fail or N/A, and a failed item can ask for a photo, a note and a severity. The field calculates a score and a Pass or Fail result, and every entry gets a clear report that you can send by e-mail, filter on and export. This guide covers installing the add-on, building a checklist, the scoring rules, running an inspection, and using the results in notifications, conditional logic and exports.

What you need

You need Gravity Forms 2.9 or newer and WordPress 6.5 or newer on PHP 7.4 or newer. The inspection itself runs in any modern phone, tablet or desktop browser; there is no app to install. The add-on makes no outside connection beyond checking gravityextra.com for your licence and plugin updates, and photos are stored on your own server.

Install and activate

  • Upload the add-on zip in Plugins → Add New → Upload Plugin and activate it.
  • Go to Forms → Settings → Inspection Checklist, enter your GravityExtra licence key and press Activate License.
  • Open a form in the form editor. The Inspection Checklist field is in the Advanced Fields group.

Without an active licence the field shows a short “not available” note on the page, submissions with the field are not accepted, and the checklist tools in the form editor are switched off. Entries you already collected stay visible in the admin.

Build the checklist

Add the Inspection Checklist field and open its settings. A new field starts with a small example checklist, so you can see how it works right away. The Checklist setting lists your sections, each with its items:

  • Type a section title, for example Fire safety, and the items to check below it, for example Extinguishers charged and tagged.
  • Use + Item to add an item to a section and + Section to add a section.
  • Use the arrows to move items and sections up or down. An item moved past the top or bottom of its section moves into the next section.
  • Use the cross to remove an item or a section.
  • Press Options on an item to open its settings. The small labels under each item show its options at a glance.
The form editor with the Inspection Checklist field: the checklist builder with sections, items, their options and the preview of the item cards
The checklist builder in the form editor, with the options of one item open.

Item options

  • Help text — a short hint shown under the item, for example what “charged” means for an extinguisher gauge.
  • Required — the item must be answered before the form can be sent. Ticking the field’s own Required box makes every item required.
  • Allow N/A — on by default. Turn it off for items that always apply, such as a spill kit that every site must have.
  • Weight — how much the item counts when the field uses weighted scoring. A weight of 3 counts three times as much as a weight of 1.
  • Photo on Fail — off, optional or required. When it is required, a failed item cannot be sent without at least one photo.
  • Note on Fail — off, optional or required. Use a required note when you need to know what is wrong and where.
  • Severity — none, chosen by the inspector when the item fails, or always a fixed severity (for example, every failure of “Fire doors close and latch” is Critical).

Paste a list

For a long checklist it is faster to paste it. Open Paste or edit as a list, paste your list and press Build from list. A line without indent is a section; an indented line, or a line starting with a dash, is an item. Options follow the item text after a vertical bar:

Fire safety
  Extinguishers charged and tagged | required | photo | note | severity
  Fire doors close and latch fully | critical | photo? | note
Housekeeping
  Spill kit stocked | no n/a | weight 2

The options are required, photo (required on Fail), photo? (optional), note, note?, weight 2 (or x2), severity (the inspector chooses), a severity name such as critical (fixed), no n/a and help: your text. Unknown options are listed under the box so you can correct them. Copy the current checklist into the box does the reverse, which is handy for editing a long checklist as text. When you rebuild a checklist, items with the same section and text keep their identity, so earlier entries still line up with them in the export.

Templates

Open Templates to reuse a checklist on other forms. Type a name and press Save as template to store the current checklist (with its severity choices). On another form, choose the template and press Load to copy it into that field, then adjust it as needed. Loading a template copies it: later changes to one form do not change the other. Templates are kept until you delete them.

Score and result

The Score and result setting decides how an inspection is graded:

  • Every item counts the same or Use item weights.
  • Pass mark (%) — a score at or above the pass mark is a Pass, below it a Fail. The default is 80%.
  • Severity choices — the list the inspector chooses from, by default Minor, Major and Critical.
  • Critical rule — when ticked, any failed item of the chosen severity (normally Critical) makes the whole inspection Fail, whatever the score.

The score is the share of passed items among the items that apply. Items answered N/A and items left unanswered do not count. A worked example with weights: brakes (weight 3) pass, tyres (weight 2) fail, lights, mirrors and horn (weight 1 each) pass. The score is (3 + 1 + 1 + 1) ÷ 8 = 75%. With a pass mark of 70% that is a Pass. If the mirrors are marked N/A instead, the score becomes 5 ÷ 7 = 71.4%, still a Pass. If the horn is a fixed Critical item and it fails, the inspection is a Fail even with a score of 87.5%.

Labels and photos

In Labels you can rename the three buttons (for example OK, Not OK and Not applicable) and the two results (for example Satisfactory and Action required). In Photos you set how many photos an item can take (1 to 5), the largest file size per photo and the size the phone makes photos before upload (1600 pixels on the longest side by default; 0 switches the resizing off).

Run an inspection on a phone

Open the page with the form on a phone. Every item is a card with big Pass, Fail and N/A buttons that are easy to hit with a thumb. Each section shows how many of its items are answered, and a bar at the bottom of the screen shows the live score, the result so far and a Jump to unanswered button that takes the inspector straight to the next open item.

The checklist on a phone: a failed extinguisher item with the severity Major, a note and a photo of the gauge, the next items answered Pass and the score bar showing 75% Failed
A failed item on a phone, with its severity, note and photo, and the live score bar.

When an item fails, its severity, note and photo boxes open. Take or add photo opens the camera or the photo library, depending on the phone. Large photos are made smaller on the phone before they are sent, which saves mobile data and storage. A thumbnail appears under the item for each photo. Changing an item back to Pass closes the boxes again.

If something is missing when the form is sent, for example a required item without an answer or a failed item without its required photo, the form shows which items need attention, and each of those items is marked. Photos already added are kept, so the inspector only fixes what is missing.

What the server checks

The score bar on the phone is only there to help the inspector. When the form is sent, the add-on reads the answers and checks everything again on the server:

  • every required item has an answer, and N/A is only accepted where it is allowed;
  • every failed item that needs a photo has one, every failed item that needs a note has one, and a severity is chosen where the inspector has to choose;
  • every photo is a real image (JPEG, PNG, GIF or WebP, checked by its content and not only its name), within the size limit and not a blocked file type;
  • the score, the result and the number of failed items are recalculated from your settings.

Any score or result posted by the browser is ignored, so the values in the entry are always the ones your rules produce.

The entry report

Each entry shows the inspection as a report: the result, the score and the pass mark, the number of passed, failed and N/A items, and a table per section with each item’s answer, its severity and note, and thumbnails of its photos. Click a thumbnail to open the photo. The entry keeps a snapshot of the checklist as it was inspected, so editing the checklist later does not rewrite earlier reports.

The entry report in the admin: result Failed with a score of 75%, and tables for Fire safety, Electrical, Housekeeping and First aid with answers, severities, notes and a photo thumbnail
The inspection report in the entry, with the score, the result and photo thumbnails.

The field has three values you can show as columns in the entry list: Score, Result and Failed items. Use Select Columns on the entry list to add them. Editing an entry in the admin keeps the inspection as it was recorded.

Merge tags for e-mails and confirmations

Use these merge tags in notifications, confirmations and anywhere else Gravity Forms replaces merge tags. Replace Inspection with your field label and 3 with your field ID; the merge tag list in the editor inserts them for you.

  • {Inspection:3:score} — the score, for example 75%.
  • {Inspection:3:result} — the result label, for example Failed.
  • {Inspection:3:failed} — the failed items as a list, each with its section, severity, note and links to its photos.
  • {Inspection:3:summary} — one line such as “Score 75% · Failed · 2 of 9 items failed · 1 not applicable”.
  • {Inspection:3} and {all_fields} — the full report.
A failed inspection e-mail: the summary line, the list of failed items with severity, notes and a photo link, and the action plan
An e-mail with the failed-items merge tag, sent only when the inspection fails.

Photo links in e-mails go through the Gravity Forms secure download link, so the real location of the file stays hidden. Anyone with the link can open the photo, so send these e-mails only to the people who need them.

Conditional logic

The score, the result and the number of failed items can be used in conditional logic. In the rule, choose Inspection (Result), is and the value fail (or pass), or Inspection (Score) with less than and a number such as 80. Typical uses:

  • show an Action plan field only when the inspection fails — it appears on the phone as soon as the live result turns to Fail;
  • send a “failed inspection” notification to the facilities team only when the result is Fail;
  • show a different confirmation message for a pass and a fail.

Notifications and confirmations use the values recalculated on the server.

Export

In Forms → Import/Export → Export Entries, the Inspection Checklist field offers a column for the score, the result, the number of failed items and a summary, plus one column per item (Pass, Fail with its severity, or N/A) and one column per note. That makes it easy to compare sites or months in a spreadsheet.

How it differs from other tools

  • Our Matrix Grid add-on is a data-entry grid of typed cells. It has no per-item Pass / Fail flow, no evidence on failures and no score.
  • Our Photo Capture add-on adds a single photo field. The Inspection Checklist asks for photos per failed item, inside the item they belong to.
  • Our survey and quiz tools grade answers against a right answer. An inspection has no right answer: it records the condition of each item, the evidence and a result.
  • Gravity Forms on its own would need a radio button field plus a conditional upload field and a note field for every item, and a calculation to score them.

Privacy and storage

Photos are stored in the form’s own Gravity Forms upload folder, which uses a hidden, hard-to-guess path, and are linked through the Gravity Forms download handler. They are kept with the entry; deleting the entry in Gravity Forms is how you remove an inspection’s record. When the phone makes a photo smaller, the photo is saved again without the extra information a camera adds, such as its location. The add-on helps you record inspections; which checks you carry out and how long you keep the records are decisions for your organisation and the rules that apply to it.

FAQ

Does the inspector need an internet connection?

The page must load and the form must be sent with a connection. Answering the items in between works on the page itself, so a short drop in coverage while walking around does not lose the answers on the screen.

Can I change the checklist after inspections were recorded?

Yes. Earlier entries keep the snapshot of the checklist they were recorded with. Items that keep their identity (the same item in the builder, or the same section and text in a pasted list) line up in the same export column.

Can I use more than one checklist in a form?

Yes. Each Inspection Checklist field has its own items, score and merge tags.

What does uninstalling remove?

The licence settings, the saved templates and the add-on settings. Forms, entries and the photos stored with entries are your records and stay where they are.

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