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

Gravity Forms Accessibility Enhancer Premium Add-on Setup Guide

Updated 9 min read Gravity Forms Integrations A–Z
On this page
  1. Video walkthrough
  2. Requirements
  3. Installation
  4. The twelve front-end fixes
  5. Error summary and live announcements
  6. Focus outline
  7. Autocomplete tokens
  8. The Accessibility panel in the form editor
  9. One-click fixes
  10. Score and CSV
  11. Per-form settings
  12. The GF theme framework and legacy markup
  13. What it checks with axe-core
  14. For developers
  15. Frequently asked questions
  16. Does this make my form WCAG compliant?
  17. Will it change how my forms look?
  18. Does the checker send my form anywhere?
  19. Why does the panel say the fix changes the saved form?

Video walkthrough

Gravity Forms Accessibility: Error Summary, Focus, Live Announcements & a WCAG Checker
Watch: switch on accessibility fixes and the WCAG checker for Gravity Forms, step by step. Watch on YouTube

The Gravity Forms Accessibility Enhancer Premium Add-on helps your forms meet WCAG 2.2 level AA. It does two jobs. First, it fixes the small gaps that Gravity Forms output still has, each fix being a switch you can turn on or off. Second, it adds an Accessibility panel to the form editor that reads every form, lists what is wrong with a severity and a WCAG reference, offers one-click fixes where they are safe, gives the form a score out of 100 and exports the list as a CSV.

Please read this once: no add-on can make a form meet WCAG by itself. The checker reads the form definition, not the page around it, and a clean result is a good start rather than a certificate. Testing with a keyboard and a screen reader is still part of the job. This guide shows what the add-on does and what it deliberately leaves alone.

The Accessibility check panel in the form editor showing a score of 5 out of 100, the counts of errors, warnings and notes, and a list of problems each with a severity label, a WCAG reference, an explanation and a one-click fix button such as Reset the label text colour to the Gravity Forms default and Set the label to Text
The panel lists every problem with its severity, the WCAG success criterion, how to fix it and a one-click fix where that is safe.

Requirements

  • WordPress 6.5 or newer and PHP 7.4 or newer (tested up to PHP 8.3).
  • Gravity Forms 2.9 or newer (tested with 2.9.8 and 3.1.2).
  • Nothing else: the add-on makes no request to any outside service for its features, and bundles no third-party script.

Installation

  1. Download the zip from your GravityExtra account and upload it in Plugins, Add New, Upload Plugin.
  2. Activate the plugin. Gravity Forms must be active.
  3. Go to Forms, Settings, Accessibility and activate your licence key.
  4. Review the twelve switches on the same page and save.
  5. Open any form in the editor and click Accessibility in the toolbar.

The twelve front-end fixes

Gravity Forms 2.5 and newer already print a lot of good markup: fieldsets and legends in the theme framework, a validation summary, aria-required and aria-invalid, and an autocomplete setting. The add-on works on top of that markup with filters, so it never replaces your theme or the Gravity Forms theme framework, and where core already does the right thing it leaves it alone. The switches are in Forms, Settings, Accessibility.

Switch What it does WCAG
Fieldset and legend Gives radio buttons, checkboxes, names, addresses, dates, times and lists a fieldset with a legend where Gravity Forms prints a plain label. This matters most for forms in legacy markup; the theme framework already groups these fields, and the add-on does not wrap them twice. 1.3.1, 3.3.2
Descriptions and errors Adds the description, the error message and the date help to the field or group with aria-describedby, and marks an invalid field with aria-invalid. 1.3.1, 3.3.1
Error summary Shows the list of errors on every form, moves focus to it after a failed send, and makes each link put the cursor in the field instead of only scrolling to it. 2.4.3, 3.3.1
Live announcements One polite live region tells screen readers how many fields need attention, which page of a multi-page form is shown, and the confirmation text after an AJAX send. 4.1.3
Required in words Adds the word required for screen readers next to an asterisk, so the meaning does not depend on a symbol or a colour. 1.4.1, 3.3.2
Autocomplete Adds the right autocomplete token to name, email, phone, address, website and password fields, and to single-line fields whose label is clearly personal data, such as Postcode or Company. 1.3.5
Focus outline A solid three pixel outline in a colour you choose, and room under a sticky header so the focused field is not hidden. 2.4.7, 2.4.11
Target size Makes checkboxes, radio buttons and the date picker button at least 24 by 24 pixels and the whole choice row clickable. 2.5.8
Date help Shows the date format under a date picker that has no description of its own. 3.3.2
Title attributes Removes title attributes from inputs, selects and text areas; they repeat the label and show a tooltip only to mouse users. 1.3.1, 4.1.2
Language Adds lang to the page when the theme left it out, and to a form that is written in another language than the page. 3.1.1, 3.1.2
Fallback names A field with an empty label gets an accessible name from its placeholder or its type, and an empty submit button text becomes Submit. 4.1.2

Error summary and live announcements

After a failed send, focus goes to the error summary at the top of the form, a screen reader hears how many fields need attention, and every link in the list puts the cursor in the first input of its field. For a group such as a radio list, the cursor lands on the first choice. On AJAX forms the same happens without a page reload, and after a successful send the confirmation text is announced and the confirmation takes focus.

A Gravity Forms error summary box that reads There was a problem with your submission and lists four links such as Email address: This field is required, each link jumping to its field
The error summary takes focus after a failed send, and each link puts the cursor in the field it names.

On multi-page forms the add-on announces the page change, for example Page 2 of 3 followed by the step name. If you also use the GravityExtra Page Transition add-on, which announces its own steps, this announcement is skipped so nothing is read twice.

Focus outline

The default Gravity Forms focus ring is a pale shadow. The add-on replaces it with a solid outline that has enough contrast against the page. You choose the colour in the settings; the default is a deep blue that passes 3:1 against white.

Autocomplete tokens

Browsers and assistive tools can fill in personal details only when the field says what it collects. The add-on supplies the tokens from the HTML specification: given-name and family-name for the name field, email, tel, url, address-line1, address-level2, address-level1, postal-code and country-name for the address, and new-password for a password field. It never touches credit card fields, which are left to the browser and the payment gateway. If Gravity Forms already sets a token for an input, yours is kept.

Open any text, email, phone, website, number, password, date or drop down field in the editor and look under Advanced for Autocomplete token. Type a token such as one-time-code or organization to override the guess, or off to switch autocomplete off for that field. For fields with several inputs, use the Gravity Forms autocomplete setting; the add-on fills the inputs you leave empty.

The Accessibility panel in the form editor

Open a form in the editor and click Accessibility in the toolbar. The panel checks the form as it is in the editor, including edits you have not saved yet, and lists the problems it finds. Nothing is sent anywhere: the check runs on your own server.

Problem Severity WCAG One-click fix
A field without a label Error 1.3.1, 3.3.2, 4.1.2 Sets the label from the placeholder or the field type
Hidden label with a placeholder as the only cue Warning 3.3.2, 1.4.3 Shows the label
Hidden label with nothing else to explain the field Warning 3.3.2 Shows the label
Personal field without autocomplete Warning 1.3.5 Sets the tokens
Two fields with the same label Warning 2.4.6 None, you choose the new names
Choice with no text Error 1.3.1, 4.1.2 None
Image choice with no alternative text Error 1.1.1 Uses the choice text as the image alternative text in the Media Library
Image CAPTCHA, maths CAPTCHA or interactive CAPTCHA Error, warning, note 1.1.1, 3.3.8 None, the add-on suggests an invisible check
Date picker with no help text Note 3.3.2 Adds the format as the description
Images without alt, vague link text such as click here, time limits in HTML fields and descriptions Error, warning 1.1.1, 2.4.4, 2.2.1 None
Section break with no title Error 1.3.1, 2.4.6 None
Submit button with no text, image button, custom required indicator without a word or symbol, steps without titles, a form that closes at a set time Error, warning, note various Button text only
Low contrast in the theme settings: label, description, input text, button text, field border, accent colour Error, warning 1.4.3, 1.4.11 Resets the colour to the Gravity Forms default

The theme contrast is computed, not guessed: the add-on takes the form style settings, the site-wide defaults and the Gravity Forms defaults, and measures each pair against the 4.5:1 limit for text and 3:1 for borders and accents. Because the add-on cannot see your page, it assumes the form sits on the background colour you set in the settings, white by default.

The Accessibility check panel in the form editor showing a score of 5 out of 100, the counts of errors, warnings and notes, and a list of problems each with a severity label, a WCAG reference, an explanation and a one-click fix button such as Reset the label text colour to the Gravity Forms default and Set the label to Text
The panel lists every problem with its severity, the WCAG success criterion, how to fix it and a one-click fix where that is safe.

One-click fixes

A fix is offered only when it cannot lose anything: it sets a label, shows a hidden label, sets an autocomplete token, adds date help, resets one colour to the default, sets the submit button text, or writes missing alternative text for an image. Fixes change the saved form, not unsaved edits in the editor, so save first and reload the editor after a fix. Every fix removes its problem from the list, which is checked by the tests of the add-on.

Score and CSV

The score is 100 minus 10 for each error, 4 for each warning and 1 for each note, never below zero. It is a way to compare forms and watch progress, not a measure of compliance. The CSV has one row per problem with the form, the field, the severity, the rule, the WCAG criterion, the explanation and the fix, and spreadsheet formula characters are neutralised so it is safe to open.

The Accessibility report page listing nine forms with a score out of 100, the number of errors, warnings and notes for each, and a CSV link per form plus a button to download one CSV for all forms
The report page gives every form a score and a CSV you can hand to a developer or an auditor.

Forms, Accessibility shows every form with its score and counts, with a CSV link per form and one for all forms.

Per-form settings

In Form Settings, Accessibility, choose whether a form follows the global switches, forces every fix on, or turns them all off. A form in another language than the page can have its language set here, for example es or fr-CA, so screen readers switch voice.

The GF theme framework and legacy markup

The add-on was tested on the Orbital theme, the Gravity theme and legacy markup. Core Gravity Forms already prints fieldsets and legends in the theme framework, including for product and option fields, so there the add-on adds nothing. In legacy markup the same questions were plain labels over a group of inputs; the add-on turns them into fieldsets with legends and resets the fieldset border and padding so the layout does not change.

What it checks with axe-core

Before each release the add-on is run against sample forms with the open source axe-core engine, with the fixes off and then on. Your results depend on your theme, but on the test site the violating nodes fell from 5 to 1 on Gravity Forms 3.1.2: the date picker button that was 22 pixels wide became 24, and a page whose theme left out the language attribute got one. The remaining finding was in the test theme, not in the forms. The axe-core library is used by the tests only and is not part of the add-on.

For developers

  • Filter gea11y_switches changes the switches of a form: it receives an array of switch name to true or false and the form id.
  • The add-on prints no inline script for the fixes; one small script and one stylesheet load only on pages that show a protected form.
  • The checker is a plain PHP class that works on the form array, so it can be run from your own tools.

Frequently asked questions

Does this make my form WCAG compliant?

No add-on can. It closes common gaps and lists the rest, but the page around the form, your content and your colours also count. Use it to help you meet WCAG 2.2 level AA and keep testing with a keyboard and a screen reader.

Will it change how my forms look?

Only where a fix needs it: the focus outline, larger checkboxes and a date format line under date pickers. Each of these is a switch.

Does the checker send my form anywhere?

No. It runs on your server and the add-on makes no outside request for its features.

Why does the panel say the fix changes the saved form?

Because the fix is written to the database, not to the open editor. Save the form, apply the fix, then reload the editor.

Find the gaps in your Gravity Forms and close them one switch at a time

Get the Accessibility Enhancer add-on

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