The Remediation Workflow
Crucible Scan identifies issues but does not automatically change your content. Remediation follows three steps: identify the problem in the scan results, make the fix in your content or theme, then verify the fix by rescanning the page.
Fixing Common Issues
Missing Image Alt Text (1.1.1)
Open the page in the WordPress editor, select the image, and add descriptive alternative text in the Image block settings panel. Alt text should describe the image’s content and function — not just “image” or the filename.
Generic Link Text (2.4.4)
Links like “click here” or “read more” do not convey their destination to screen reader users. Edit the link text to describe where it goes, such as “Read our accessibility policy” instead of “Click here.”
Missing Page Language (3.1.1)
WordPress sets the lang attribute automatically based on your site language. If this test fails, go to Settings → General and verify the Site Language is correct.
Heading Hierarchy (1.3.1)
Headings should follow a logical hierarchy without skipping levels. An <h2> should not jump directly to an <h4>. Review your page structure and adjust heading levels accordingly.
Missing Form Labels (3.3.2)
Every form input needs a visible label programmatically associated with it using the for attribute. Check your form plugin settings for label visibility options.
Issue Actions
| Action | When to Use | Effect |
|---|---|---|
| Manual Resolve | After you have fixed the issue in your content | Moves to Resolved tab; status persists across future scans |
| Dismiss | Third-party content, false positive, or intentional choice | Moves to Dismissed tab; excluded from compliance score |
| Rescan | After making a fix, to verify it worked | Re-tests the page and updates results |
Edit & Locate PRO
With Pro, each issue card includes an Edit button that opens the WordPress editor and highlights the exact element that triggered the issue, eliminating the need to search through your content manually.
Critical severity issues block access to core content for users with disabilities. Addressing these first has the largest positive impact on your site’s accessibility.