Skip to content
CMS Max Documentation

HTML Improvement Suggestions

How to use the HTML Suggestions tool in SEO Max to improve your site's accessibility and search performance, including fixing color contrast issues.

Overview

The HTML Suggestions tool analyses your site's pages and flags common issues that can affect both your search engine rankings and the experience of visitors — including those with accessibility needs. Addressing these suggestions helps your site perform better and reach a wider audience.

Accessing HTML Suggestions

  1. Click SEO Max in your admin menu
  2. Select HTML Suggestions
  3. Review the list of flagged issues

HTML Suggestions list

Each suggestion includes which page has the issue and a description of what needs attention.

Types of Suggestions

The tool looks for a range of common issues, including:

  • Missing or duplicated page titles
  • Missing meta descriptions
  • Images without descriptive text (alt text)
  • Headings that are out of order or missing
  • Links with unclear labels
  • Color contrast issues that make text hard to read
  • Other markup improvements that search engines and accessibility tools recommend

Addressing these issues makes your pages easier for search engines to understand, and more accessible to all visitors.


Fixing Color Contrast Issues

One of the most common HTML suggestions is a color contrast warning: "Background and foreground colors do not have a sufficient contrast ratio."

What This Means

This warning appears when the contrast between your text color and its background color is not strong enough for comfortable reading. This particularly affects visitors with visual impairments, including color blindness.

Search engines also factor accessibility into their quality assessments, so poor contrast can have a small but real impact on rankings.

The Required Standard

For normal-sized text, the recommended minimum contrast ratio is 4.5:1. This is a standard set by web accessibility guidelines and is what Google's tools check against.

How to Choose Better Colors

Option 1: Use an AI assistant

You can ask an AI assistant (such as ChatGPT, Claude, or similar) to suggest accessible alternatives that are still close to your current brand colors. Describe your current colors and ask for suggestions that meet accessibility standards. For example, tell it your primary and secondary colors and ask what nearby shades would pass the 4.5:1 contrast requirement.

Option 2: Use a contrast checker tool

Free tools such as WebAIM Contrast Checker or Colour Contrast Analyser let you enter two colors and instantly see their contrast ratio. Adjust the shades until the ratio meets the 4.5:1 threshold.

General guidance:

  • Make one of the two colors significantly lighter or darker than the other
  • Dark text on a light background and light text on a dark background are both valid approaches
  • Avoid placing two mid-tone colors next to each other — the contrast is usually too low

Applying the Fix

Once you have chosen accessible colors, update your site's color settings in the admin panel under your theme or design settings. If you are unsure where to make color changes, contact your support team for assistance.


Why These Suggestions Matter

Improving your site's markup quality has compounding benefits:

  • Better search rankings — Search engines reward well-structured, accessible pages
  • More visitors — Pages that are easier to index rank higher and appear more often in results
  • Wider audience — Accessible design ensures your content reaches people with disabilities
  • Professional impression — A polished, well-functioning site builds trust with visitors

Working through HTML suggestions regularly — particularly after major content updates — keeps your site in good shape over time.