DocumentationFixing

Applying and undoing fixes

Markup fixes, CSS fixes, the preview and diff, the override layer, and what happens when your theme outranks a rule.

Nothing is applied without you reading it first. There is no bulk-apply-everything button, and that is deliberate.

Two kinds of fix

Markup fixes change the HTML of the page: adding an alt attribute, naming a button, correcting a heading level.

CSS fixes change styling: contrast, target size, link underlines. These are written into your site’s Additional CSS, where you can read, edit or delete them without this plugin installed.

Which one a finding gets is a property of the finding, not a choice you make. A contrast problem is not fixable in markup, and a missing button name is not fixable in CSS.

Reviewing before applying

Every proposed fix is shown as:

  • a preview of the result
  • a diff of what changes

You approve it, edit it, or leave it. Approving it is a deliberate act.

The override layer

Applied markup fixes are stored in a reversible override layer. Your content is never overwritten.

This matters more than it sounds. It means:

  • Every fix can be reverted individually.
  • Removing the plugin returns your markup to exactly what it was.
  • Your post content in the database is untouched, so nothing else that reads it is surprised.

Alt text is the deliberate exception. It is written to WordPress’s own alt text field on the media item, because that is where it belongs and where everything else expects to find it. See Describing images.

Checking the fix actually worked

After a style rule is applied, the page is loaded again and measured again.

If your theme or page builder styled the same element with a more specific rule, the fix will have done nothing. Rather than reporting success, the plugin tells you it was overridden.

Suggested style rules are weighted to outrank what is already there. Where nothing can outrank it — most often because the existing rule is marked !important — the plugin says so instead of pretending.

What a fix will not do

  • It will not change content it cannot see, which includes anything rendered by JavaScript after the page has loaded.
  • It will not guess at meaning. Where a correct fix depends on what an image is for or what a link promises, the plugin asks you rather than producing a plausible sentence and leaving you to notice it was wrong.
  • It will not touch your front end for visitors beyond the fix itself. Nothing is injected, no widget is added, no script runs for the public.

Last updated . Something here wrong or missing? Tell us and we will fix it.