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 August 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

  • home — The homepage — the root of the site.
  • landing_page — A standalone campaign or marketing landing page outside the normal site structure.
  • search_results — On-site search results.

Products and purchase

  • product — A single product or service detail page.
  • product_category — A product listing or category overview.
  • pricing — Pricing, plans, or tariff pages.
  • cart — The shopping cart.
  • checkout — Any step of the checkout flow.
  • thank_you — Order or signup confirmation — the page shown after a completed transaction.

Content

  • blog_article — A single blog post or article.
  • blog_category — A blog overview or article listing.
  • case_study — A customer case study or success story.

Company

  • about — About, team, and company pages.
  • career — Job listings and career pages.
  • contact — Contact pages and forms.

Account and access

  • login — Sign-in pages.
  • signup — Registration and account-creation pages.

Help and legal

  • support — Help center, documentation, FAQ.
  • legal — Imprint, privacy policy, terms.

Fallback

  • unknown — The 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.