Skip to content

Remove Product Tours from posthog.com#16756

Merged
adboio merged 3 commits into
masterfrom
posthog-code/remove-product-tours
May 20, 2026
Merged

Remove Product Tours from posthog.com#16756
adboio merged 3 commits into
masterfrom
posthog-code/remove-product-tours

Conversation

@posthog
Copy link
Copy Markdown
Contributor

@posthog posthog Bot commented May 6, 2026

Summary

Removes Product Tours from the site since it's no longer being built. Customers and leads have been reaching out asking to be included in the alpha — taking it down so the inbound stops.

What changed

  • Deleted /docs/product-tours and /docs/api/product-tours (docs, API reference, snippets, landing page)
  • Removed the roadmap board entry on the homepage (src/components/Home/Board)
  • Stripped from navigation (src/navs/index.js — both the docs sidebar and the API docs nav)
  • Removed from product hooks (src/hooks/useProduct.ts, src/hooks/featureDefinitions/products.tsx) and deleted src/hooks/featureDefinitions/product_tours.tsx
  • Cleaned up the comparison-table feature wiring and removed product_tours rows from every competitor data file
  • Removed from the homepage taskbar/control surfaces (Home/Control, HeroCarousel/slides, Products/ProductsTest, ProductComparisonTable)
  • Removed broken /docs/product-tours/* links from blog posts, the use-case-selling handbook playbooks, the sales product-enablement page, and one newsletter
  • Removed the Vale lint entries that enforced the product name
  • Added vercel.json redirects so /docs/product-tours and /docs/api/product-tours (plus subpaths) land on the docs index

Mentions of competitors' product-tour features in blog posts (Pendo, Userpilot, Userflow, Appcues, etc.) are kept — they're factually accurate and don't link to anything that's been deleted.

Test plan

  • pnpm start renders the homepage without the Product Tours roadmap card or product entry
  • /docs/product-tours and /docs/api/product-tours 301 to the docs indexes via the new redirects
  • Docs sidebar nav no longer shows a Product Tours section; API nav no longer lists Product Tours
  • Pendo / Userpilot / Amplitude / Fullstory comparison pages render without the Product Tours row and don't error on the missing feature definition
  • pnpm check-links-post-build is clean (no remaining broken links to /docs/product-tours/*)

Created with PostHog Code

Removes the Product Tours product from the site since it is no longer
part of the roadmap. Deletes the docs (/docs/product-tours and
/docs/api/product-tours), the landing page, the roadmap board entry,
the navigation entries, the product hooks, the feature definitions,
and competitor comparison rows. Updates handbook playbooks, blog
posts, and the newsletter to remove broken links and stale framing.
Adds vercel.json redirects so old URLs land on the docs index.

Generated-By: PostHog Code
Task-Id: 9798a171-47ed-45f5-b2bc-91e2be7461ac
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 6, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview May 20, 2026 02:35PM

@charlescook-ph charlescook-ph requested review from a team and raquelmsmith May 6, 2026 13:48
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 6, 2026

Vale prose linter → found 55 errors, 310 warnings, 0 suggestions in your markdown

Full report → · Copy the Job Summary code block into an LLM to batch-fix issues.

Note: Too many findings to show inline. See the Job Summary linked above.

File Errors Warnings Suggestions
contents/blog/best-pendo-alternatives.mdx 1 147 0
contents/docs/integrate/_snippets/install-web.mdx 0 3 0
contents/handbook/growth/sales/product-enablement.md 6 31 0
contents/handbook/growth/use-case-selling/growth-and-marketing.md 34 68 0
contents/handbook/growth/use-case-selling/product-intelligence.md 14 50 0
contents/handbook/growth/use-case-selling/use-case-selling.md 0 1 0
contents/newsletter/hidden-danger-of-shipping-fast.md 0 10 0

@charlescook-ph
Copy link
Copy Markdown
Collaborator

tagging a few folks as it touches a bunch of places:

@charlescook-ph charlescook-ph marked this pull request as ready for review May 6, 2026 13:50
The GH Actions Gatsby cache is keyed on pnpm-lock.yaml and
gatsby-config.js, neither of which changed in this PR. Cached
mdx-scopes-dir shims from previous builds still import this snippet,
so webpack fails to resolve it. Restoring the file as a stub keeps
the build green; once the cache naturally rotates the stub becomes
orphan and can be removed.

Generated-By: PostHog Code
Task-Id: 9798a171-47ed-45f5-b2bc-91e2be7461ac
Copy link
Copy Markdown
Contributor

@gewenyu99 gewenyu99 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

seems legit

Comment thread vercel.json
{ "source": "/posts/:path*", "destination": "/posts/[slug]/index.html" }
],
"redirects": [
{ "source": "/docs/product-tours", "destination": "/docs", "statusCode": 301 },
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These are a little suspect tbh... I'm not sure, maybe it should just 404? Or maybe we should build a page explaining that we don't build this anymore? Like a lil farewell blog?

Copy link
Copy Markdown
Member

@raquelmsmith raquelmsmith left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thank you!

'product_analytics',
'web_analytics',
'product_analytics.features.autocapture',
'product_tours',
Copy link
Copy Markdown
Contributor

@natalia-amorim natalia-amorim May 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@charlescook-ph we don't want to remove it altogether from the comparisons tables; PostHog doesn't have it but our competitors still do and it's part of doing a fair comparison, so I think this is more about flipping PostHog to 'false' and removing the alpha mentions.

Can you discard all the blog changes from the commit and I'll create a PR for the blog specifically?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@natalia-amorim try tagging posthog for changes, I think we can do this?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah I went old school and did my own separate PR, already merged

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

- Take master's version of competitor comparison tables (per
  natalia-amorim review): keep product_tours rows in blog comparison
  tables and competitor data files so competitors with the feature
  still show up correctly; PostHog flips to available: false
- Restore featureDefinitions/product_tours.tsx and its registration in
  ProductComparisonTable so product_tours rows render
- Fix dead /docs/product-tours/start-here link in best-pendo-alternatives.mdx

Generated-By: PostHog Code
Task-Id: f04870e3-19b3-465a-8936-ad87333d8ec3
@adboio
Copy link
Copy Markdown
Contributor

adboio commented May 20, 2026

@natalia-amorim i made some changes here, could you pls take a look?

@adboio adboio merged commit b35b52f into master May 20, 2026
20 checks passed
@adboio adboio deleted the posthog-code/remove-product-tours branch May 20, 2026 15:06
cleo-pleurodon added a commit that referenced this pull request May 27, 2026
…aster

Master removed the Product Tours product in #16756 (deleted docs, landing
page, and nav entries). This branch was still adding back the Product
Tours docs sidebar block, causing a merge conflict in src/navs/index.js.

Remove both Product Tours entries from src/navs/index.js (the API
reference link and the main docs sidebar section) so the three-way merge
against master is clean again.

Generated-By: PostHog Code
Task-Id: c0d6ec58-56fd-41f2-a83d-d098d1ef26cb
cleo-pleurodon added a commit that referenced this pull request May 27, 2026
* fix(nav): use valid @posthog/icons names for docs menu items

Five icon names referenced in src/navs/index.js don't exist in @posthog/icons,
so the resolver in TaskBarMenu silently rendered no icon for those entries.

- IconInbox -> IconNotebook (PostHog Code > Inbox, Support > Inbox management)
- IconLayoutDashboard -> IconDashboard (PostHog Code > Command Center)
- IconGitFork -> IconGitRepository (PostHog Code > Worktrees)
- IconMail -> IconLetter (Support > Email channel)
- IconGitHub -> IconGithub (Support > GitHub integration; casing)

Generated-By: PostHog Code
Task-Id: 680d1cf1-2902-4dca-9b31-1f8546f84152

* fix(nav): more docs menu icon fixes + diversify Support → Guides colors

Follow-ups from review:

- PostHog Code → Inbox: IconLetter (mail icon, per feedback)
- PostHog Code → Command Center: IconGridMasonry (square split into a grid)
- Diversify Support → Guides colors (all entries were orange) and swap
  Slack integration's icon to IconChat to avoid duplicating IconMessage
  with Widget setup

Also fix other docs nav items whose icon names didn't resolve in
@posthog/icons:

- Product tours → Customize styles: IconColor → IconPalette
- Customer analytics → B2B mode: IconCohort → IconGroups
- Customer analytics → Create usage metrics: IconG (typo) → IconGraph
- Endpoints → Rate limits: IconGauge → IconDashboard

And add a fallback in TaskBarMenu/menuData.tsx so icon names that exist
only in src/components/OSIcons/Icons.tsx (e.g. IconTag, IconAnthropic,
IconOpenAI, IconClaudeCode, IconGemini, IconLangChain, IconOpenRouter,
IconOpenClaw) resolve too. PostHog Icons still take precedence so JSX
usage like <Icons.IconApps /> is unchanged.

Generated-By: PostHog Code
Task-Id: 680d1cf1-2902-4dca-9b31-1f8546f84152

* Revert: don't add OSIcons fallback to TaskBarMenu icon resolver

Keep the import surface in menuData.tsx unchanged per review feedback.
The local-OSIcons-only names (IconTag, IconAnthropic, IconClaudeCode,
IconGemini, IconLangChain, IconOpenAI, IconOpenRouter, IconOpenClaw)
were already silently failing before this PR and remain a separate
problem to solve elsewhere.

Generated-By: PostHog Code
Task-Id: 680d1cf1-2902-4dca-9b31-1f8546f84152

* fix(nav): drop Product Tours entries to resolve merge conflict with master

Master removed the Product Tours product in #16756 (deleted docs, landing
page, and nav entries). This branch was still adding back the Product
Tours docs sidebar block, causing a merge conflict in src/navs/index.js.

Remove both Product Tours entries from src/navs/index.js (the API
reference link and the main docs sidebar section) so the three-way merge
against master is clean again.

Generated-By: PostHog Code
Task-Id: c0d6ec58-56fd-41f2-a83d-d098d1ef26cb
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.

5 participants