Developer docs

Page Categories

A page-level dimension that classifies every URL by the role it plays on your site — from Home and Product to Checkout and Legal.

v3.0Updated May 2026

Role, not topic

Page categories describe what a page is, not what it is about. A blog article about your pricing strategy is a blog_article, never pricing — the category captures the page's function, so a session can be read as a sequence of roles: landed on the homepage, browsed a product, checked pricing, entered checkout.

The categories

Every page resolves to exactly one of these categories:

Entry and discovery

  • homeThe homepage — the root of the site.
  • landing_pageA standalone campaign or marketing landing page outside the normal site structure.
  • search_resultsOn-site search results.

Products and purchase

  • productA single product or service detail page.
  • product_categoryA product listing or category overview.
  • pricingPricing, plans, or tariff pages.
  • cartThe shopping cart.
  • checkoutAny step of the checkout flow.
  • thank_youOrder or signup confirmation — the page shown after a completed transaction.

Content

  • blog_articleA single blog post or article.
  • blog_categoryA blog overview or article listing.
  • case_studyA customer case study or success story.

Company

  • aboutAbout, team, and company pages.
  • careerJob listings and career pages.
  • contactContact pages and forms.

Account and access

  • loginSign-in pages.
  • signupRegistration and account-creation pages.

Help and legal

  • supportHelp center, documentation, FAQ.
  • legalImprint, privacy policy, terms.

Fallback

  • unknownThe page was evaluated, but no category was supported clearly enough by the evidence.

How a page is classified

Every page is scored against all categories using three groups of evidence:

  • URL structure. Path segments are the strongest signal — /checkout, /pricing, /blog/…, or a product-detail URL pattern.
  • Page metadata. Title, headings, meta description, and structured data — a schema.org Product or BlogPosting type is strong evidence.
  • Page content. Where available, datataste's page snapshots add visual evidence about the page's layout and elements.

A category is assigned only when its score clearly beats every other candidate. Pages that don't clear the bar stay unknown — deliberately, because a wrong category is worse than an honest unknown. Rules are versioned, and pages are re-evaluated as the rules improve.

Where it appears

The dimension shows up on two levels: every tracked event carries the category of the page it happened on, and every session additionally carries the category of its landing page. That's why the chart library has both "Pageviews by Category" and "Landing Page Categories".

Good to know

Overrides win. You can override any page's category by hand; automation never overwrites a manual value. See AI Derived Dimensions for the shared mechanics.