Skip to main content

Fixing Issues

This guide provides a systematic approach to fixing issues detected by Auditoro. Follow these steps to improve your site's health score.

General Workflow​

  1. Prioritize - Focus on critical issues first
  2. Group - Fix related issues together
  3. Fix - Make the necessary changes
  4. Verify - Run a new scan to confirm
  5. Document - Note what you changed

Fixing by Category​

SEO Issues​

Missing Title Tags​

Fix: Add a unique <title> tag to each page.

<head>
  <title>Page Topic | Your Site Name</title>
</head>

If using a CMS:

  • WordPress: Edit the page and set the SEO title
  • Check if a plugin (Yoast, Rank Math) handles titles
  • Review your theme's title template

Duplicate Titles​

Fix: Make each page's title unique.

  1. Export the list of pages with duplicate titles
  2. Create unique titles for each page
  3. Update via CMS or code

Template approach:

Blog posts: [Post Title] | Blog | Site Name
Product pages: [Product Name] | Shop | Site Name
Category pages: [Category] Products | Site Name

Missing Meta Descriptions​

Fix: Add compelling meta descriptions.

<meta name="description" content="A clear, engaging summary of this page's content. Include a call to action.">

Content Issues​

Fix: Update or remove broken links.

  1. For each broken link, determine:

    • Does the target page exist elsewhere? → Update the link
    • Was the page deleted intentionally? → Remove the link or find alternative
    • Was the page deleted accidentally? → Restore it or redirect

  2. Set up redirects for moved content:

    location = /old-page {
      return 301 /new-page;
    }

Spelling Errors​

Fix: Correct misspellings or add to custom dictionary.

  1. Review each flagged word
  2. If misspelled: Fix in your content
  3. If valid word: Add to custom dictionary

Performance Issues​

Missing Compression​

Fix: Enable gzip/brotli on the public-facing layer that serves the response.

In many deployments this is a reverse proxy such as Caddy or nginx, not the application runtime itself. Validate the fix against the public URL and check for a Content-Encoding header on the live response.

See Performance Checks for server-specific instructions.

Security Issues​

HTTPS Errors​

Fix: Install and configure SSL correctly.

  1. Get a certificate (Let's Encrypt is free)
  2. Install on your server
  3. Redirect HTTP to HTTPS
  4. Test with SSL Labs

Mixed Content​

Fix: Update all resources to HTTPS.

  1. Find HTTP resource URLs in your code/content
  2. Update to HTTPS or protocol-relative URLs
  3. Check third-party resources support HTTPS

Accessibility Issues​

Missing Alt Text​

Fix: Add descriptive alt attributes.

<img src="product.jpg" alt="Blue running shoes, model X200, side view">

Guidelines:

  • Describe the image content
  • Keep under 125 characters
  • Use empty alt (alt="") for decorative images

Verifying Fixes​

After making changes:

  1. Deploy changes to your live site
  2. Wait for propagation (CDN, cache clearing)
  3. Run a new scan in Auditoro
  4. Compare results to previous scan
  5. Confirm issues are resolved

Common Mistakes​

Fixing Symptoms, Not Causes​

Wrong: Fixing one broken link at a time Right: Finding why links break (moved pages, no redirects) and fixing the process

Ignoring Instead of Fixing​

The "Ignore" status should be rare. If you're ignoring many issues, you may be avoiding necessary work.

Not Verifying​

Always run a follow-up scan. Fixes sometimes don't work as expected, and new issues can appear.

Fixing Everything at Once​

Large changes make it hard to identify what worked. Fix issues in groups and scan between changes.

Automation Opportunities​

Prevent issues from recurring:

Pre-deploy Checks​

Add these to your CI/CD:

  • Linting for HTML structure
  • Link checking
  • Image alt verification

CMS Validation​

Configure your CMS to:

  • Require titles and meta descriptions
  • Require alt text on images
  • Validate URLs before publishing

Monitoring​

Use scheduled scans to catch regressions quickly.

Getting Help​

If you're stuck on an issue:

  1. Check the issue's "How to fix" section
  2. Search documentation for the issue type
  3. Contact support at support@auditoro.io