PostHog Handbook Library / Content

1,143 words. Estimated reading time: 6 min.

Newsletter

Our newsletter is called build mode. It's owned by Ian.

Sent and managed via Substack, we put together an issue planning content for each installment of the newsletter. One person writes it and Andy edits and publishes it.

The newsletter is long-form, original copy, often based on blog posts we already wrote. It focuses on product and business lessons and information for engineers.

We run ads to drive subscriptions for this newsletter.

Art from previous newsletters is in Figma and diagrams are in FigJam.

How to write a good newsletter

These aren’t rules, just things that have worked well in the past. They provide some guidance on writing a successful newsletter.

Topic

Title

Intro

Structure

Style & tone

Publishing details

Having a good post preview (hero) image is important. Build mode hero images use an origami/paper style. To create one:

  1. Find an image of an object that fits the post.
  2. Give it to Gemini with this prompt:

Reimagine this object as if it was made out of origami/flat lay paper, keep the background completely blank/white and try to keep to the original image as possible.

  1. If the result looks grey or drab, ask Gemini to change the colors.
  2. Import it into Figma and use the AI remove background action to remove the white background.

You can find more examples in the Newsletter Graphics Figma file. If you get stuck, open an art request to have the make one for you (give them at least 1 week to do so).

The image needs to be 1920x1080 px for the posthog.com blog image, 1200x630 px for the Substack preview image, 995x398 px for X, and 1441x810 px for LinkedIn.

We publish the newsletter on Substack and then add it to posthog.com/newsletter via GitHub.

Make sure links in the newsletter point to posthog.com and include UTMs like ?utm_source=posthog-newsletter&utm_medium=post&utm_campaign=enter_name_here.

Canonical URL: https://posthog.com/handbook/content/newsletter

GitHub source: contents/handbook/content/newsletter.md

Content hash: 4452693a586c14a0

Static reader notes
  • MDX_COMPONENT_STATIC_ADAPTER: Adapted interactive MDX components for static reading: PrivateLink, SmallTeam.