How to fix missing schema article on HubSpot CMS
Add Article schema markup (JSON-LD) to every blog post and editorial page so Google can identify and rich-result-enhance your content in search.
Steps for HubSpot CMS
- Go to Marketing → Website → Blog → Blog Settings → check if HubSpot is injecting Article schema automatically (it does for most templates since 2021). Verify with the Rich Results Test first.
- If schema is missing or incomplete, open the HubSpot Design Manager, locate your Blog Post template, and add an HubL 'html_tag' or raw HTML module containing the JSON-LD script block.
- Use HubL variables ({{ content.name }}, {{ content.publish_date }}, {{ content.blog_author.display_name }}) to populate fields dynamically.
- Publish and validate with the Rich Results Test.
What is missing schema article?
Article schema is a small block of structured data — written in a format called JSON-LD — that you embed in a page's HTML to tell Google (and other search engines) that the page is an article, who wrote it, when it was published, and what it's about. Think of it as a machine-readable label that sits invisibly in your page code. Without it, Google has to guess at all of those details. With it, Google has certainty — and that certainty unlocks extra search features. This is especially important for the Answer Engine Optimization (AEO) pillar: search engines increasingly pull answers directly from structured, labeled content, and Article schema is the foundation that makes your editorial pages eligible for that treatment.
Pages with Article schema are eligible for Google's rich results — including enhanced article cards in Discover, "Top stories" carousels, and knowledge-panel-style answer snippets — which can dramatically increase click-through rates compared to plain blue links. As AI-driven search features (like Google's AI Overviews and Bing's Copilot) look for authoritative, well-labeled sources to cite in direct answers, missing Article schema means your content is less likely to be selected as a source, costing you visibility even when your writing is excellent. For ecommerce stores with blogs, guides, or how-to content, this directly affects the organic traffic those pages drive to product pages. It's a zero-cost technical change with a measurable traffic upside.
See the complete Missing schema article guide for every platform and the full background.
Not sure if your HubSpot CMS store has this?
Run a free SEOLZ scan — we’ll find missing schema article and every other issue across your whole site.
Scan my site free