Skip to content

Conversation

@radhikagpt1208
Copy link
Contributor

@radhikagpt1208 radhikagpt1208 commented Nov 13, 2025

This PR adds headings issues detection to the preflight audit. When a webpage is scraped, all heading elements are validated and are reported with SEO impact, actionable recommendations and AI generated suggestions.

The headings audit in preflight will now return opportunities in this format:

{
	"result": [
      {
        "pageUrl": "https://author-p125761-e1234605.adobeaemcloud.com/content/aso-preflight/index/preflight-headings-test.html",
        "step": "suggest",
        "audits": [
          {
            "name": "headings",
            "type": "seo",
            "opportunities": [
              {
                "check": "heading-missing-h1",
				 "seoRecommendation": "Pages should have exactly one H1 element for SEO and accessibility.",
				 "issue": "Missing H1 Heading",
				 "issueDetails": "Page does not have an H1 element",
                "seoImpact": "High",
				 "aiSuggestion": "Explore Pain Perception: Insights and Reflections"
				},
				{
					"check": "heading-order-invalid",
					"seoRecommendation": "Heading levels should increase by one (example: H1→H2), not jump levels (example: H1→H3).",
					"issue": "Invalid Heading Order",
					"issueDetails": "Heading hierarchy skips levels.",
					"seoImpact": "Moderate",
					"suggestion": "Adjust heading levels to maintain proper hierarchy."
				},
				{
					"check": "heading-order-invalid",
					"seoRecommendation": "Heading levels should increase by one (example: H1→H2), not jump levels (example: H1→H3).",
					"issue": "Invalid Heading Order",
					"issueDetails": "Heading hierarchy skips levels.",
					"seoImpact": "Moderate",
					"suggestion": "Adjust heading levels to maintain proper hierarchy."
				}
            ]
          }
        ]
      }
    ]
}

Please ensure your pull request adheres to the following guidelines:

  • make sure to link the related issues in this description
  • when merging / squashing, make sure the fixed issue references are visible in the commits, for easy compilation of release notes
  • If data sources for any opportunity has been updated/added, please update the wiki for same opportunity.

Related Issues

Thanks for contributing!

@github-actions
Copy link

This PR will trigger a minor release when merged.

@radhikagpt1208 radhikagpt1208 changed the title feat: adding headings check in preflight feat: introduce headings check in preflight Nov 18, 2025
@radhikagpt1208 radhikagpt1208 changed the title feat: introduce headings check in preflight feat: introduce headings audit in preflight Nov 18, 2025
@radhikagpt1208 radhikagpt1208 merged commit 0733a90 into main Nov 20, 2025
8 checks passed
@radhikagpt1208 radhikagpt1208 deleted the headings-preflight branch November 20, 2025 06:34
solaris007 pushed a commit that referenced this pull request Nov 20, 2025
# [1.247.0](v1.246.6...v1.247.0) (2025-11-20)

### Bug Fixes

* optionally processing all forms opportunity ([#1607](#1607)) ([008f5f5](008f5f5))
* test failures ([#1615](#1615)) ([d898d82](d898d82))

### Features

* [SITES-36639] Spacecat A11y Autofix suggestion grouping ([#1449](#1449)) ([11359ac](11359ac))
* introduce headings audit in preflight ([#1562](#1562)) ([0733a90](0733a90))
@solaris007
Copy link
Member

🎉 This PR is included in version 1.247.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants