Form Label Auditor

WHAT IT DOES

Form Label Auditor is a browser extension that scans any webpage for form inputs (input, textarea, select) and checks if they have associated labels. It highlights inputs that are missing labels with a red outline and warning label, and displays a list of all form inputs with their label status. The tool identifies different types of label associations: explicit labels (label with for attribute), implicit labels (input inside a label), aria-label, aria-labelledby, placeholder, and title attributes. It is ideal for web developers, accessibility testers, and anyone who wants to ensure forms are accessible and properly labeled for all users.

WHERE IT RUNS

Form Label Auditor runs on any webpage, overlaying a floating panel that does not interfere with page content. It operates entirely in your browser as a lightweight userscript, scanning the DOM for form inputs. It works on any page, whether static or dynamic, with no external dependencies. All settings are stored locally using GM_setValue—no data is ever sent to any server.

HOW TO USE

After installation, open the floating panel by clicking the extension icon. The panel shows the current status (Enabled or Disabled) and a toggle button to enable or disable the auditor. The panel displays a summary of form inputs: total inputs found, how many have labels, and how many are missing labels. A list shows each input with its label text, input type, name, and label status. Click any item in the list to focus and scroll to that input on the page. Inputs with labels are highlighted green; inputs missing labels are highlighted red with a warning label. Click the "Scan Page" button to manually rescan. The tool automatically rescans when the page content changes. All settings are saved per website.

REAL MECHANISM — WHY THIS WORKS

Most form accessibility checkers require manual inspection or complex auditing tools that run separately. Form Label Auditor uses a DOM-scanning approach that identifies form inputs and checks their label associations. The tool queries the page for all input, textarea, and select elements, then checks each one for label associations in order of precedence: explicit label with the for attribute matching the input's id, implicit label (input inside a label element), aria-label attribute, aria-labelledby attribute, placeholder attribute, and title attribute. Each input is classified as having a label or not, and the label type is recorded. The tool generates unique CSS selectors for each input and applies a colored outline (green for labeled, red for missing) with a warning label for missing labels. A list of all inputs is displayed with status badges, and each item is clickable to focus the corresponding input. This approach ensures accurate, fast, and fully private form label auditing without requiring any external services or network access.

THE PANEL

The floating panel is fully draggable and remembers its position per site, snapping to the edges of the viewport when dragged near them. You can collapse the panel to a small icon to minimize screen distraction and expand it back with a single click. The panel is resizable from the bottom-right corner, giving you more space to view the form input list. Press the Escape key to close the panel instantly. The panel remains open across page navigation within the same domain, maintaining your current view state. All preferences—panel position and enabled state—are saved per domain for a seamless experience.

PLEASE NOTE

Form Label Auditor requires the free BotGentz extension to be installed and enabled, as it relies on the cross-extension messaging API provided by BotGentz for DOM access permissions. The tool checks for label associations based on standard accessibility practices. It does not check for label quality or whether the label text is descriptive. Password inputs are excluded from the audit for security reasons. The tool highlights inputs with colored outlines; these are purely visual and do not modify the page content. All settings are stored locally in your browser using GM_setValue. No form data, page content, or usage information is ever sent to any server. The extension does not read, store, or transmit any personal information. It only scans and highlights form inputs at your request.