Product & feature comparisons
Contents
Keeping product comparison charts up-to-date across a large website with multiple products is tricky, so we've built a way to source data from a single place. That way, if a competitor adds a new feature (or updates an existing one), we can update the data in one place and have it automatically reflected across the entire website in existing product comparison tables, blog posts, and other documentation.
To do this, we need a source of record for:
- feature definitions (each PostHog product and its feature set)
- competitor data (each competitor and their product and feature offerings)
By standardizing all features across all products and competitors, we can generate a comparison table without any hard-coded data.
Example
This is not an ordinary Markdown table. (In fact, it's not Markdown at all!)
See more examples in the PostHog vs Amplitude blog post. All tables are dynamically rendered from data sourced from json arrays.
Product & platform features
Feature definitions for PostHog products are stored in:
Session Replay example:
/src/hooks/featureDefinitions/session_replay.tsx
Features can live in the features node, or nested inside in a logical grouping. (This is a truncated example.)
Competitor (& PostHog) data
Competitor data is stored in:
Amplitude example:
/src/hooks/competitorData/amplitude.tsx
Feature-level data for competitors is stored in the same format, with the exception being that products are namespaced under the products node in a single file instead of being spread across multiple files for each product.
There's also a platform node below the product array.
Referencing data
There are several ways to assemble competitor tables. It uses the <ProductComparisonTable /> component which uses <OSTable /> internally.
Compare products between competitors
This will list out the top-level product names and descriptions.
Render all items within a node
Use features to render all items inside the node.
This is helpful for comparing all features within a product without having to reference them individually.
Compare specific features between competitors
If you want to cherry-pick specific features, just reference the key directly. (This is useful for blog posts that compare specific features between competitors in a manually set order.)
Override label/description but source values from competitor files
This is useful when referencing a global feature but want to tailor the label or description to be more personalized to the product or feature.
Example: If there's a global data retention for 7 years but in reference to heatmaps, you might want to say "Heatmap data retained for 7 years."
Add custom line items with arbitrary values
If you need to add a custom row that doesn't exist in the competitor data, you can use the values property to specify a value for each competitor.
The values array should have the same length as the competitors array, with each value corresponding to a competitor in order.
Section headers
Add section headers to organize comparison tables into logical groups. Headers only require a label property:
Headers automatically span across all columns and are styled with a border to visually separate sections.
Product page overrides
Excluding sections
Product pages list out all sections within a product's feature set by default, but in some cases it doesn't make sense to do so.
For example, showing the platform.integrations section might make sense for the Product Analytics comparison, but not for LLM Analytics comparison where that product doesn't really integrate with the tools that are otherwise integrated across the PostHog platform.
If you want to exclude a section from rendering, you can use the excludedSections property.
For product pages, this is handled by the excluded_sections property in the product's feature definition file.
/src/hooks/productData/llm_analytics.tsx:
Excluding rows with missing data
By default, the component will show rows where a competitor's cell doesn't have a value. This can be overridden on a per-product basis by setting require_complete_data: true in the product's feature definition file.
/src/hooks/productData/product_analytics.tsx:
PostHog is an all-in-one developer platform for building successful products. We provide product analytics, web analytics, session replay, error tracking,feature flags, experiments, surveys, LLM analytics, data warehouse, CDP, and anAI product assistant to help debug your code, ship features faster, and keep all your usage and customer data in one stack.