Skip to content
AEOprobe
Platform guide

AEO for HubSpot CMS

Use HubSpot’s domain and page settings for crawler rules, canonicals and sitemaps. Inspect the actual theme output to see which schema types it includes.

Updated

Default robots.txt behavior

To edit the file, open Settings → Content → Pages → the domain or default settings → SEO & Crawlers → Robots.txt. That interface supports domain-specific overrides. You do not need a HubL robots template. HubSpot system hs-sites domains have separate indexing restrictions.

Decide whether to permit search and user-fetch crawlers separately from training crawlers, within the controls your platform provides. See how AEOprobe distinguishes crawler roles.

Default structured data

Check the JSON-LD that your actual HubSpot theme and custom code publish. You can add JSON-LD through a page’s Head HTML or an appropriate template. New website pages and blog posts have self-referencing canonicals by default. Blog listing pages do not.

Common AEO issues

Common AEO issues, their impact and fixes
IssueImpactFix
The wrong domain’s crawler file is editedImpactThe public site continues to serve different rules.FixSelect the intended domain in Content → Pages. After saving, inspect its public /robots.txt.
A landing page is missing from the sitemapImpactA page you want listed has not been added in the sitemap settings.FixReview the selected domain’s sitemap. Live website pages and blog posts are added automatically. Landing pages must be added by hand.
One page’s JSON-LD is placed in a domain-wide headerImpactUnrelated pages receive the same page-specific facts.FixFor that script, use the page’s Head HTML or a content-specific template. Do not use Site Header HTML.

Step-by-step guide

  1. 1

    Review the intended domain’s rules

    Open Settings → Content → Pages. Select the domain, then open SEO & Crawlers → Robots.txt. Make the crawler-policy change you intend and save. Then inspect the public file.

  2. 2

    Check canonical and sitemap inclusion

    If you need a canonical override, open Settings → Advanced → Customize canonical URL in the content editor. To add landing pages to the sitemap, open Settings → Content → Domains & URLs → Sitemap. Select the domain and use +Add a page for the landing pages you want included. Then save.

  3. 3

    Add markup at the correct scope

    Open the relevant website page or blog content → Settings → Advanced → Additional code snippets → Head HTML. Add reviewed page-specific JSON-LD only to fill a gap. Then select Publish or Update. Available fields and permissions vary by subscription and content type. Inspect the published result.

Official documentation

Questions

Do all HubSpot themes provide the same schema?

Not necessarily. The set of schema types can differ between themes, and a higher tier does not always mean more schema. Check the published JSON-LD from the theme and any custom modules before you add another script.

Which SEO recommendations are available?

Individual-page SEO recommendations are available in all accounts. The domain SEO scanning tool requires Marketing Hub or Content Hub Professional or Enterprise. Neither tool replaces checking the markup actually published on a page.

The free audit checks up to 3 public pages with no sign-up. Structured data checks read JSON-LD only. Microdata and RDFa are not parsed. Findings do not guarantee rankings or AI citations.

A saved-site audit costs 20 credits. It covers up to 10 pages on Free, 50 on Watch and 100 on Pro. AEOprobe plans are Free at €0/month, Watch at €7/month and Pro at €21/month. Your account shows what you can buy.

Run the free audit on your site