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.
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
| Issue | Impact | Fix |
|---|---|---|
| The wrong domain’s crawler file is edited | ImpactThe 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 sitemap | ImpactA 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 header | ImpactUnrelated 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
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
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
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
- HubSpot robots.txt settings(opens in a new tab)
Domain selection, full-file editing and system-domain restrictions.
- HubSpot code snippets(opens in a new tab)
Page and domain header fields, access and publishing.
- HubSpot canonical URLs(opens in a new tab)
Defaults and content-level overrides.
- HubSpot sitemaps(opens in a new tab)
Automatic inclusion and manually adding landing pages.
- HubSpot SEO recommendations(opens in a new tab)
Page recommendations and paid domain-scanning access.
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