Skip to content

docs: clarify GA per-page tracking requires frontmatter title#515

Merged
Ehesp merged 2 commits into
mainfrom
docs/analytics-frontmatter-title
Jul 3, 2026
Merged

docs: clarify GA per-page tracking requires frontmatter title#515
Ehesp merged 2 commits into
mainfrom
docs/analytics-frontmatter-title

Conversation

@alexdukeinvertase

@alexdukeinvertase alexdukeinvertase commented Jul 3, 2026

Copy link
Copy Markdown
Member

Fixes #457

Summary

  • Document that Google Analytics reads page_title from the document <title>, which docs.page sets from frontmatter title (falling back to docs.json name, then "Documentation").
  • Add a troubleshooting row and verify warning in the analytics customize guide.
  • Note that body # headings do not set the document title, and that GTM users configure GA tags in their container.

Scope

  • app/ (hosted site, MCP, Ask AI)
  • packages/cli/
  • packages/mdx-bundler/
  • docs/ (product documentation)
  • Repo / CI / other

Type of change

  • Bug fix
  • New feature
  • Documentation
  • Refactor / chore

Test plan

  • bun run check passes locally
  • Tested locally (bun dev, CLI command, or other relevant command)
  • Updated docs/ (if user-facing)
  • Verified on a docs.page URL or local preview (if rendering/routing changed)

Notes for reviewers

Docs-only change. Closes the documentation gap from #296 / #457 — no code changes to analytics injection.

Made with Cursor

Co-authored-by: Cursor <cursoragent@cursor.com>
@docs-page

docs-page Bot commented Jul 3, 2026

Copy link
Copy Markdown

To preview the documentation for this pull request, visit the following URL:

use.docs.page/~515

Documentation is deployed and generated using docs.page

The per-page title guidance is behavioral context for accurate reports,
not a caution about risky or irreversible actions.

Co-authored-by: Cursor <cursoragent@cursor.com>
@alexdukeinvertase alexdukeinvertase requested a review from Ehesp July 3, 2026 14:26
@Ehesp Ehesp marked this pull request as ready for review July 3, 2026 14:33
@Ehesp Ehesp merged commit 8028f47 into main Jul 3, 2026
2 checks passed
@Ehesp Ehesp deleted the docs/analytics-frontmatter-title branch July 3, 2026 14:33
@railway-app railway-app Bot temporarily deployed to docs.page / docs.page-pr-515 July 3, 2026 14:33 Destroyed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation: Clarify that Google Analytics page tracking requires frontmatter title

2 participants