Content is the main pillar of our marketing strategy. As our products are quite technical in nature, we believe that frequent and regular content output helps improve acquisition and ongoing product engagement. The blog is where we publish interesting product content, share feature updates, and tell PostHog stories.
Content & SEO strategy
Content & SEO is a long-term strategy. We are focused on generating a sustained output of high quality content that is genuinely valuable to users. Rather than scale up content output for the sake of it, our strategy is to go deeper and create better content as we grow, not simply push out more articles for its own sake. For this reason, we never set ourselves specific content output targets.
We win on depth, not breadth, of content. We believe a small number of high quality pieces > a larger number of medium quality pieces.
We use SEMRush to track and optimize our ranking for the keywords that we think are target customers are using to search for solutions like PostHog online. If you need access, please ask Andy.
The top keywords are then used as the basis of our content strategy. We bucket our content into three buckets:
SEO-optimized content, written by the Marketing team. The purpose of these is to improve our topical authority and visibility in areas relevant to our target audience, and generate organic inbound demand and word of mouth awareness.
Tutorials, written mostly by the Marketing team. The purpose of these is to encourage new signups (because we show potential users how to solve their problems using PostHog), as well as helping existing customers. Some tutorials are also SEO-optimized, especially when they cover general product analytics topics (e.g. 'how to calculate and reduce churn.')
Brand building and community engagement, written by anyone on the team, with the Marketing team acting as editors. These can be about anything, and their purpose is to drive one-off spikes in awareness through virality on sites like Hacker News and Reddit.
Andy and Ian are currently the main people responsible for our regular content output. James H and Joe are also frequent contributors.
You can view planned content on the Marketing project board using the "content" label filter.
All planned content will have an issue created for it. We also maintain a long list of possible content ideas in this GitHub issue.
Join our #content-ideas Slack channel, raise an issue, or comment on the ideas long list issue to suggest a content idea. Community members can suggest them to Andy directly or via the User slack channel!
Content categories
As we have a few different places where content lives on our site, follow these guidelines to figure out where your content fits best. Sometimes you will find that the content you've created fits better in Docs rather than on the Blog.
- Blog post = Virtually all SEO-specific content (e.g. 7 best open source analytics solutions); brand building content (e.g. CEO diaries, news).
- Docs - Tutorial = Anything that basically explains 'how to do X'. This includes content created for SEO purposes that explains how do something in PostHog (e.g. how to build an AARRR funnel).
- Docs - Manual = Reference guides to PostHog features (e.g. Actions, Funnels).
- Docs - Everything else = Everything else product-specific that isn't covered above (e.g. deployment documentation).
The Marketing team is responsible for 1. and 2. generally, while 3. and 4. usually sit with the Website & Docs team. We do encourage teams to step on toes, however.
Production workflow
Our content production workflow is as follows:
Create a GitHub issue: Create a new blog post issue in the posthog.com repo. Use the New blog post idea issue template. Fill in the required information as well as adding any additional information that you feel is beneficial to someone reviewing the issue. Add this issue to the Marketing GitHub project.
Shoot a video (optional): This could be an interview, talk, panel discussion, or tutorial recording. We’ll eventually edit this down to about half or a third of its size.
Content interviews usually take 40-60 minutes, and we generate 20-30 questions for each interviewee. These questions range from their career history to their current role and product, plus a few personal questions to add flavor to the interview. Here’s an example of one we did with Eltje.
HogTalks are Zoom sessions where we invite an expert to speak on a specific topic. We package these videos for upload to our YouTube channel - no blog post required, just a transcript where appropriate. Here’s an example.
The engineering team sometimes creates tutorials that we use to explain certain PostHog features. These can be turned into blog posts in their own right. Here’s an example.
Get the transcript (optional): We use Rev.com to pull the transcript from the video. Rev also lets you get a quick draft in just a few minutes, though we recommend waiting for the proper version, which can take anywhere from a few hours if ‘rushed’ - which costs extra - to a day or two.
Write the blog post: We write up a concise blog post about the discussion or tutorial (with the help of the transcript, if available). This is where we add more context to the topic and include links to other content for further reading. The length of a blog post can vary wildly. If based on a video a 60-minute interview usually yields a ~1,500-word blog post.
Get feedback: Once written, if the blog post is to be published on the PostHog blog, push it to GitHub and create a Pull Request for feedback. See Publishing for more information. If the blog post is going to be published on an external site, use Google Docs to get feedback.
Artwork: Things that are more interesting to the eye are more likely to be clicked on. Each blog post or tutorial need an accompanying image. Learn more in the Publishing section below.
Extract the audio from the edited video (optional): This goes into the podcast.
Amplify the content: After the blog post is complete, we pull snippets from it and schedule them for publishing across social media platforms and encourage the rest of the PostHog team to share within their networks. The blog post GitHub issue provides an "amplification checklist" that should be followed. Note that we generally discourage the use of hashtags on Twitter, especially when used mid-tweet.
Publishing
Our Marketing project board is our source of truth for all content. We use the 'content' label for all issues and PRs.
Submit a PR to posthog/posthog.com with the following content:
A new Markdown file (md, mdx) in
/contents/blog/
Any assets added to a new folder under
contents/images/blog/
Each post should have artwork. If you deem your post worthy of custom art, add the Artwork project board to your post's issue. Please ensure you have a target publish date specified in the issue - at least 3 working days out, so we have time to produce artwork. Lottie will create the artwork and add the image to your issue.) Once that's done, be sure to save the post image to the relevant directory.
We encourage custom artwork on posts that will be (or are likely to be) amplified, whether paid or organic. But we also maintain a library of reusable artwork. Andy will select an appropriate image in this scenario.
Blog artwork is displayed in three places: above the post itself, on the
/blog
index page, and is also used as the post's Open Graph image.We have two display modes for how the post image and title appear. Use the
featuredImage
property in the post's frontmatter like in this example.- If the post's image has a white background or has text that needs to be unobfuscated, use
featuredImageType: standard
. (This will prevent our Open Graph Image generator from overlaying the title and author info on the image, and will stack the artwork and blog title on the actual blog post page.) - Otherwise, use
featuredImageType: full
. This should generally be used unless you're sure you need the above option.
- If the post's image has a white background or has text that needs to be unobfuscated, use
Add the author of the post as an array (not a string), like in this example. If this is your first time posting to the blog, add yourself to authors.json.
Assign the post just one
category
and any relevant tags usingcategory
andtags
in the frontmatter section, as follows:category: Startupstags:- Guides- Open source
The following are our pre-approved categories and tags. Please don't create new ones without Andy's approval:
Categories:
- Inside PostHog: Behind-the-scenes on our culture, what we’re doing
- Using PostHog: Guides about doing stuff in PostHog
- PostHog news: Product updates, release notes and announcements
- CEO diaries: Insights from James Hawkins
- Startups: Guides and insights on startup life
- HogMail: The PostHog newsletter on the blog
- Product growth: Guides about product analytics, growth hacking et al.
- Engineering: Blogs about engineering at PostHog
- General: Category for blog posts with no obvious category
Tags:
- Guides: Any and all guides from all categories (actionable)
- Explainers: Blogs explaining a concept or idea (non-actionable)
- Product analytics: Blogs about about product analytics
- Product metrics: Blogs about metrics and what to track
- Session recording: Blogs about using session recording
- Feature flags: Blogs about using feature flags
- Marketing: Blogs about marketing
- Privacy: Blogs about GDPR and other fun stuff
- Open source: Blogs about open source products and projects
- Release notes: PostHog release notes
- Product updates: General product updates
- Comparisons: PostHog vs other things
- ClickHouse: Blogs about ClickHouse
- Y Combinator: Blogs about YC
Add a meta description using
description
in the frontmatter section (optional)Set the date of the blog post to the intended publishing date in the format
YYYY-MM-DD
. Posts dated in the future won't display on the site until their specified date, though a build is required day-of in order to publish the post. (The Website & Docs team or other Vercel admins can kick off a manual build.)Create an annotation on app.posthog.com for the content to track the effect.
Fully completed and correct frontmatter should look like this:
---date: 2021-06-10title: PostHog raises $15 million Series B for open source product analyticsrootPage: /blogsidebar: BlogshowTitle: truehideAnchor: truefeaturedImage: ../images/blog/series-b/series-b-baby.pngfeaturedImageType: fullauthor: ["joe-martin"]categories: ["Product analytics", "Guides"]---
Distribution
The blog post GitHub issue template outlines how the content should be amplified and distributed. This can and should be edited for each post using the team's experience and ideas to identify what's best on a post-by-post basis.
This section excludes Paid Ads, which are covered elsewhere.