HubSpot CMS for Marketers cheat sheet
HubSpot CMS for Marketers · Keep the key ideas within reach.
CMS Content Creation and Management
HubSpot's content tools split into three editors: the page editor for website and landing pages, the blog editor for posts, and the email editor; each saves as a draft until explicitly published.
A module is a reusable content block; a global module edits in one place and updates every page that uses it, while a local module edits independently per page.
Drag-and-drop areas accept modules only where the template defines a droppable region; content outside those regions must be changed in the template or theme source.
The content staging environment creates a separate copy of the site for testing theme and template changes before pushing them live; publishing staging overwrites the live theme.
Smart content rules (list membership, device type, country, referral source) display different module variants to different visitors while serving one URL.
Version history on pages and blog posts stores prior saved versions; restoring a version replaces current content, so copy text out before restoring if it must be kept.
HubDB stores structured rows used by dynamic pages; each row can generate its own URL through a dynamic page template, and table rows are editable by non-developers.
Scheduling a page or post sets a future publish date; scheduled content is not publicly reachable until that timestamp passes in the account's configured time zone.
Deleting content moves it to a recycle bin recoverable for a limited window; permanently deleting before that window ends is irreversible.
Website Pages and Templates
A template defines the layout and editable regions; a page created from it inherits the layout but can only edit content inside designated editable areas.
Landing pages are intended for campaign conversion with minimal navigation; website pages are intended for the persistent site structure and are indexed as part of it.
A theme bundles templates, modules, CSS, and JS; child themes inherit the parent and override only specified files, so parent updates propagate.
Required fields on a page (internal name, page title, URL, meta description) must be filled before publish; missing required fields block the publish action.
URL changes on a live page should be paired with a redirect; HubSpot's URL redirect tool maps old paths to new ones and preserves inbound link equity.
Domain configuration separates primary domains per content type: one domain can serve site pages while another serves blog or landing pages, set in domain settings.
Preview links render a page without publishing; preview URLs are shareable but not indexed, and preview content is not served to general visitors.
Page performance depends on template assets: render-blocking scripts and unoptimized images in the template affect every page built from it, not just one.
Blog and Content Strategy
A blog is a content type with its own listing template, post template, authors, tags, and settings for comments, RSS, and per-post URLs.
Tags group posts by topic and generate tag listing pages; each tag page is indexable and should have distinct content or be consolidated to avoid thin duplicate pages.
Authors are managed as objects with name, bio, and avatar; the author profile is attached to each post and appears in the post template and structured data.
HubSpot's content strategy tools surface topic suggestions and cluster recommendations based on the connected search data for the portal's country and language settings.
A content pillar (pillar page plus cluster posts) links cluster posts to one comprehensive page; internal links from clusters to the pillar concentrate topical relevance.
Blog subscription types let visitors opt into specific content categories; each subscription type maps to a separate communication preference in the contact record.
RSS settings control feed title, item count, and whether the full post or a summary is syndicated; changing the feed URL breaks existing subscribers.
Post scheduling supports a future publish time and, separately, social sharing messages scheduled at publish; the two schedules are independent.
SEO and On-Page Optimization
On-page SEO fields per page: page title (title tag), meta description, canonical URL, and robots meta directives such as noindex.
The page title is the primary on-page ranking signal among editable fields; the meta description does not directly rank but influences click-through rate in results.
A canonical URL tells search engines which URL is authoritative when the same content is reachable at multiple paths; self-referencing canonicals are the default.
noindex removes a page from search results while keeping it crawlable; robots.txt blocks crawling entirely, so a blocked page cannot pass link equity.
Redirect type matters: 301 passes link equity permanently, 302 is temporary; use 301 for permanent URL moves and 302 for short-term tests.
HubSpot's SEO recommendations scan pages for issues such as missing meta descriptions, duplicate titles, and overly long titles, and list them per page.
Image alt text describes image content for accessibility and image search; decorative images should use empty alt attributes rather than keyword-stuffed text.
Structured data (schema markup) added to a template enables rich results; invalid markup is ignored by search engines rather than penalized outright.
Reporting and Analytics
The analytics tools separate traffic sources into organic search, direct, referral, social, email, paid, and other; source attribution depends on tracking parameters and referrer data.
Sessions count visits; a single contact can generate multiple sessions. Contacts count unique people identified via forms or cookies, so the two metrics are not interchangeable.
Attribution reports credit conversions to touchpoints under a chosen model; first-touch credits the earliest interaction, last-touch credits the final one before conversion.
The traffic analytics report shows page views, sessions, and bounce rate per page; bounce rate in HubSpot counts sessions with no subsequent interaction or page view.
Form submission reports tie submissions to the page and source that produced them; a form embedded on multiple pages attributes to the page where submission occurred.
Campaign reporting groups assets under a campaign object; assigning a campaign to pages, emails, and posts is required for cross-channel campaign rollups.
The sources report can be filtered by date range and compared against a prior period; comparisons require identical filters on both ranges.
A/B tests on pages and emails report a winner based on the chosen success metric; sample size and test duration determine whether the difference is meaningful.
CMS Content Creation and Management
Draft, scheduled, and published are distinct states; only published content is served at its public URL.
Global modules propagate edits to all instances; local modules do not.
Content staging is a full site copy used to test theme changes before going live.
Smart content varies by list membership, device, country, or referral source at a single URL.
HubDB rows can drive dynamic pages, each row producing its own URL.
The recycle bin allows recovery for a limited period before permanent deletion.
Version history restores prior saved versions of a page or post.
Website Pages and Templates
Templates define layout and editable regions; pages inherit layout and edit only within those regions.
Landing pages target conversion with minimal navigation; website pages form the persistent indexed site.
Themes bundle templates, modules, CSS, and JS; child themes override parent files selectively.
Required page fields must be complete before the publish action succeeds.
URL redirects map old paths to new ones and preserve inbound link equity.
Preview links are shareable but not indexed and not served to general visitors.
Template-level assets such as render-blocking scripts affect every page built from that template.
Blog and Content Strategy
A blog has its own listing template, post template, authors, tags, and RSS and comment settings.
Tag pages are indexable; thin or duplicate tag pages should be consolidated or noindexed.
Authors are objects with name, bio, and avatar attached to each post.
Pillar-and-cluster linking concentrates topical relevance through internal links to the pillar page.
Blog subscription types map to separate communication preferences on the contact record.
RSS item count and full-versus-summary syndication are configurable; changing the feed URL breaks subscribers.
Post publish scheduling and social sharing scheduling are independent settings.
SEO and On-Page Optimization
Editable SEO fields per page: title tag, meta description, canonical URL, and robots directives.
The title tag is the strongest editable on-page ranking field; meta description affects click-through, not ranking directly.
Canonical URLs designate the authoritative URL among duplicates; self-referencing canonicals are the default.
noindex removes a page from results but keeps it crawlable; robots.txt blocks crawling and prevents equity flow.
301 redirects pass equity permanently; 302 redirects are temporary and used for short-term moves.
SEO recommendations flag missing descriptions, duplicate titles, and overly long titles per page.
Decorative images should carry empty alt attributes; descriptive alt serves accessibility and image search.
Reporting and Analytics
Traffic sources: organic search, direct, referral, social, email, paid, and other, based on referrer and tracking parameters.
Sessions count visits; contacts count unique identified people, so one contact can produce many sessions.
First-touch credits the earliest interaction; last-touch credits the final interaction before conversion.
Bounce rate counts sessions with no subsequent interaction or page view after landing.
Form submissions attribute to the page where the submission occurred, even if the form appears on several pages.
Campaign rollups require assigning the campaign object to each page, email, and post.
Date-range comparisons require identical filters applied to both periods.
A/B test winners depend on the chosen success metric plus adequate sample size and duration.
Website Pages and Templates
A child theme inherits the parent theme and overrides only specified files, so parent updates reach the child.
Domain settings assign different primary domains per content type, such as blog versus site pages.
Landing pages typically suppress site navigation to reduce exits before conversion.
Publishing content staging overwrites the live theme, so verify changes before pushing.
Editable regions outside droppable areas require template or theme source edits.
Internal page name is for organization only and does not appear to visitors.
Page URL slugs should be short, lowercase, hyphenated, and stable after publish.
Blog and Content Strategy
Blog comments can be enabled, disabled, or moderated per blog settings.
Each blog post URL derives from the blog's configured domain plus the post slug.
Author profiles feed the post template and structured data for byline attribution.
Content strategy suggestions are based on connected search data for the portal's country and language.
Cluster posts link up to the pillar page; the pillar links down to each cluster post.
Subscription types appear as separate opt-in preferences in the contact record.
RSS feed title, item count, and syndication format are set at the blog level.
SEO and On-Page Optimization
Duplicate titles across pages are flagged as an SEO issue in the recommendations scan.
Overly long title tags are truncated in results and flagged by the SEO scan.
Schema markup enables rich results; invalid markup is ignored rather than penalized.
A blocked page in robots.txt cannot pass link equity to other pages.
302 redirects suit short-term tests; 301 suits permanent URL changes.
Canonical tags consolidate ranking signals when content exists at multiple URLs.
Meta descriptions should be unique per page to differentiate snippets in results.
Reporting and Analytics
Sessions exceed contacts whenever returning or anonymous visitors browse repeatedly.
Attribution model choice changes which channel receives credit for a conversion.
Bounce rate is a session-level metric, not a contact-level metric.
Campaign reporting requires the campaign object to be assigned to assets.
Page-level traffic reports show views, sessions, and bounce rate per URL.
Comparing periods requires matching filters on both date ranges.
A/B test results need sufficient sample size before declaring a winner.
CMS Content Creation and Management
Scheduled content becomes publicly reachable only after its publish timestamp.
HubDB tables support dynamic pages where each row generates a URL.
Smart content serves variants by list, device, country, or referral source.
Global module edits update all pages using that module.
Local module edits affect only the page being edited.
Restoring version history replaces current content with the chosen prior version.
Recycle bin recovery is time-limited; permanent deletion is irreversible.
Website Pages and Templates
Website pages are indexed as part of the persistent site structure.
Landing pages are built for campaign conversion rather than site navigation.
Preview links are not indexed by search engines.
Required fields block publishing until completed.
URL redirects preserve inbound link equity after a path change.
Child themes override parent files selectively.
Template assets affect performance across all pages using the template.
Blog and Content Strategy
Tag listing pages are indexable and can create thin duplicate content if unmanaged.
Author objects store name, bio, and avatar for byline display.
Pillar pages link to cluster posts; clusters link back to the pillar.
Blog subscription types map to contact communication preferences.
RSS feed URL changes break existing subscribers.
Post scheduling and social sharing scheduling are independent.
Content strategy suggestions derive from connected search data by country and language.
SEO and On-Page Optimization
Self-referencing canonicals are the default canonical setting.
noindex keeps a page crawlable but removes it from results.
robots.txt blocks crawling entirely and prevents equity flow.
301 redirects are permanent; 302 redirects are temporary.
Meta descriptions influence click-through rate, not direct ranking.
SEO recommendations list issues such as missing meta descriptions per page.
Empty alt attributes suit decorative images; descriptive alt serves accessibility.
Reporting and Analytics
First-touch attribution credits the earliest touchpoint in the journey.
Last-touch attribution credits the final touchpoint before conversion.
Form submission reports attribute to the page where the submission occurred.
Campaign rollups require the campaign object assigned to each asset.
Bounce rate counts sessions with no further interaction after landing.
Sessions and contacts differ because one contact can generate many sessions.
Date-range comparisons require identical filters on both ranges.
A/B test validity depends on sample size and test duration.
CMS Content Creation and Management
Draft content is not served at its public URL until published.
Global modules propagate edits; local modules do not.
Content staging is a separate full-site copy for testing theme changes.
Smart content varies module output at one URL by visitor attributes.
HubDB rows can each generate a distinct dynamic page URL.
Version history restores prior saved versions of a page or post.
Recycle bin recovery is limited in time before permanent deletion.
Website Pages and Templates
Templates define layout and editable regions; pages edit only within those regions.
Landing pages minimize navigation to reduce pre-conversion exits.
Child themes inherit the parent and override only specified files.
Required page fields must be filled before publishing succeeds.
URL redirects map old paths to new ones and preserve link equity.
Domain settings can assign different primary domains per content type.
Preview links are shareable but not indexed and not served to general visitors.
Blog and Content Strategy
Each blog has its own listing template, post template, authors, and tags.
Tag pages are indexable and should be consolidated if thin or duplicate.
Author profiles feed the post template and structured data.
Pillar-and-cluster internal linking concentrates topical relevance.
Blog subscription types appear as communication preferences on contacts.
RSS settings control item count and full-versus-summary syndication.
Post publish scheduling and social sharing scheduling are set independently.
SEO and On-Page Optimization
The title tag is the strongest editable on-page ranking field.
Meta descriptions affect click-through rate rather than direct ranking.
Canonical URLs designate the authoritative URL among duplicates.
noindex removes pages from results while keeping them crawlable.
robots.txt blocks crawling and prevents link equity flow.
301 redirects pass equity permanently; 302 redirects are temporary.
SEO scans flag missing descriptions, duplicate titles, and overly long titles.
Reporting and Analytics
Traffic sources include organic search, direct, referral, social, email, paid, and other.
Sessions count visits; contacts count unique identified people.
Attribution models change which channel receives conversion credit.
Bounce rate is measured per session, not per contact.
Form submissions attribute to the page where the submission occurred.
Campaign reporting requires assigning the campaign object to assets.
A/B tests need adequate sample size and duration before declaring a winner.
CMS Content Creation and Management
Scheduled content becomes publicly reachable only after its publish timestamp.
HubDB tables drive dynamic pages with one URL per row.
Smart content serves variants by list, device, country, or referral source.
Global module edits update every page using that module.
Content staging is a full site copy used to test theme changes.
Version history restores a prior saved version, replacing current content.
Permanent deletion from the recycle bin is irreversible.
Website Pages and Templates
Website pages are indexed as part of the persistent site structure.
Landing pages target campaign conversion with minimal navigation.
Child themes override parent files selectively while inheriting the rest.
Required fields block publishing until completed.
URL redirects preserve inbound link equity after path changes.
Preview links are not indexed by search engines.
Template-level assets affect performance across every page built from it.
Blog and Content Strategy
Blog tags generate indexable tag listing pages that need content management.
Author objects store name, bio, and avatar for byline display.
Cluster posts link to the pillar page; the pillar links to each cluster post.
Blog subscription types map to separate contact communication preferences.
Changing the RSS feed URL breaks existing subscribers.
Post scheduling and social sharing scheduling are independent settings.
Content strategy suggestions derive from connected search data by country and language.
SEO and On-Page Optimization
Self-referencing canonicals are the default canonical setting.
noindex keeps pages crawlable but removes them from results.
robots.txt blocks crawling entirely and prevents equity flow.
301 redirects are permanent; 302 redirects are temporary.
Meta descriptions influence click-through rate, not direct ranking.
SEO recommendations list issues such as missing meta descriptions per page.
Decorative images should carry empty alt attributes.
Reporting and Analytics
First-touch attribution credits the earliest touchpoint in the journey.
Last-touch attribution credits the final touchpoint before conversion.
Form submission reports attribute to the page where submission occurred.
Campaign rollups require the campaign object assigned to each asset.
Bounce rate counts sessions with no further interaction after landing.
Sessions and contacts differ because one contact can generate many sessions.
Date-range comparisons require identical filters on both ranges.
A/B test validity depends on sample size and test duration.
CMS Content Creation and Management
Draft content is not served at its public URL until published.
Global modules propagate edits; local modules do not.
Content staging is a separate full-site copy for testing theme changes.
Smart content varies module output at one URL by visitor attributes.
HubDB rows can each generate a distinct dynamic page URL.
Version history restores prior saved versions of a page or post.
Recycle bin recovery is limited in time before permanent deletion.
Website Pages and Templates
Templates define layout and editable regions; pages edit only within those regions.
Landing pages minimize navigation to reduce pre-conversion exits.
Child themes inherit the parent and override only specified files.
Required page fields must be filled before publishing succeeds.
URL redirects map old paths to new ones and preserve link equity.
Domain settings can assign different primary domains per content type.
Preview links are shareable but not indexed and not served to general visitors.
Blog and Content Strategy
Each blog has its own listing template, post template, authors, and tags.
Tag pages are indexable and should be consolidated if thin or duplicate.
Author profiles feed the post template and structured data.
Pillar-and-cluster internal linking concentrates topical relevance.
Blog subscription types appear as communication preferences on contacts.
RSS settings control item count and full-versus-summary syndication.
Post publish scheduling and social sharing scheduling are set independently.
SEO and On-Page Optimization
The title tag is the strongest editable on-page ranking field.
Meta descriptions affect click-through rate rather than direct ranking.
Canonical URLs designate the authoritative URL among duplicates.
noindex removes pages from results while keeping them crawlable.
robots.txt blocks crawling and prevents link equity flow.
301 redirects pass equity permanently; 302 redirects are temporary.
SEO scans flag missing descriptions, duplicate titles, and overly long titles.
Reporting and Analytics
Traffic sources include organic search, direct, referral, social, email, paid, and other.
Sessions count visits; contacts count unique identified people.
Attribution models change which channel receives conversion credit.
Bounce rate is measured per session, not per contact.
Form submissions attribute to the page where the submission occurred.
Campaign reporting requires assigning the campaign object to assets.
A/B tests need adequate sample size and duration before declaring a winner.
CMS Content Creation and Management
Scheduled content becomes publicly reachable only after its publish timestamp.
HubDB tables drive dynamic pages with one URL per row.
Smart content serves variants by list, device, country, or referral source.
Global module edits update every page using that module.
Content staging is a full site copy used to test theme changes.
Version history restores a prior saved version, replacing current content.
Permanent deletion from the recycle bin is irreversible.
Website Pages and Templates
Website pages are indexed as part of the persistent site structure.
Landing pages target campaign conversion with minimal navigation.
Child themes override parent files selectively while inheriting the rest.
Required fields block publishing until completed.
URL redirects preserve inbound link equity after path changes.
Preview links are not indexed by search engines.
Template-level assets affect performance across every page built from it.
Blog and Content Strategy
Blog tags generate indexable tag listing pages that need content management.
Author objects store name, bio, and avatar for byline display.
Cluster posts link to the pillar page; the pillar links to each cluster post.
Blog subscription types map to separate contact communication preferences.
Changing the RSS feed URL breaks existing subscribers.
Post scheduling and social sharing scheduling are independent settings.
Content strategy suggestions derive from connected search data by country and language.
SEO and On-Page Optimization
Self-referencing canonicals are the default canonical setting.
noindex keeps pages crawlable but removes them from results.
robots.txt blocks crawling entirely and prevents equity flow.
301 redirects are permanent; 302 redirects are temporary.
Meta descriptions influence click-through rate, not direct ranking.
SEO recommendations list issues such as missing meta descriptions per page.
Decorative images should carry empty alt attributes.
Reporting and Analytics
First-touch attribution credits the earliest touchpoint in the journey.
Last-touch attribution credits the final touchpoint before conversion.
Form submission reports attribute to the page where submission occurred.
Campaign rollups require the campaign object assigned to each asset.
Bounce rate counts sessions with no further interaction after landing.
Sessions and contacts differ because one contact can generate many sessions.
Date-range comparisons require identical filters on both ranges.
A/B test validity depends on sample size and test duration.