SEO X-Ray

SEO X-Ray

A detailed breakdown of your page's metadata, headings, images, and on-page SEO elements.

What it analyzes

The SEO X-Ray tab inspects the following elements on your page:

  • Title tag — the current value, character length, and status.
  • Meta description — the current value, character length, and status.
  • Open Graph tags — og:title, og:description, and og:image.
  • Canonical tag — whether a canonical URL is set and its value.
  • H1 headings — the total count and the text content of each H1 element.
  • Images — total image count and the ratio of images with alt text.
  • Word count — total visible words on the page.
Tip
Aim for a title length of 50 – 60 characters and a meta description length of 120 – 160 characters. These ranges give you the best chance of displaying fully in search results without truncation.

Status indicators

Each element is assigned one of three statuses, displayed with a colored badge:

  • Good (green) — the element is present and meets the recommended criteria.
  • Warning (yellow) — the element exists but needs attention (for example, a title that is too long).
  • Missing (red) — the element was not found on the page.

Common issues and fixes

Below are the most frequent issues the SEO X-Ray detects, along with how to resolve them:

  • Missing title — add a <title> tag inside your <head>.
  • Title too long — keep your title under 60 characters to prevent truncation in search results.
  • Missing meta description — add a <meta name="description"> tag. Keep the content under 160 characters.
  • Missing OG tags — add og:title, og:description, and og:image meta tags to control how your page appears when shared on social platforms.
  • No canonical tag — add a <link rel="canonical"> tag to prevent duplicate content issues.
  • Missing alt text on images — add descriptive alt attributes to every <img> tag for accessibility and image search visibility.

How to fix issues

Align gives you two paths to resolve the issues it finds:

  • Automated PR — select the issues you want to fix in the right-side action panel, then click Create PR. Align generates a pull request on your linked GitHub repository with the recommended fixes. See the Creating Pull Requests guide for details.
  • Manual fix — use the X-Ray results as a checklist and update your codebase directly. Run a new scan afterward to confirm the fixes.

Next steps