PostHog Handbook Library / Community

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

Covering the community

Auto TL;DR

At a Glance

This long page covers these main areas. The list is generated from the article headings, so it updates with every handbook rebuild.

  1. Community surfaces
  2. Where to look
  3. External pull requests
  4. Reddit
  5. How often to check
  6. When to reply
  7. Where to send people
  8. If you do not know the answer

This page explains what covering the online community involves: what to watch, when to reply, and what to do when something goes wrong.

Almost nothing here is urgent. There is no response time target. If you are not sure about something, ask in #team-builder-relations.

These processes are new, and we still change them often. Read this page as the current state, not as a settled policy.

Community surfaces

Four spaces:

Where to look

Slack shows everything for the forum and Discord. You do not need to open either one to see what is new. GitHub and Reddit are not in Slack, so check them directly.

| Channel | What it carries | | --- | --- | | #community-questions | Each new forum question, and a morning digest of the questions with no answer | | #discord-feed | Every Discord message, as a card with a "See message" button | | #community-escalations | Anything a community moderator sends to us |

External pull requests

External contributors open real pull requests, and they deserve an answer. Our job is to make sure each one gets to a team that can review it. We do not review the code ourselves.

Look for open pull requests from external contributors that are not drafts, and that:

For now, ask Claude to find these for you. We're building a dashboard that will show them in one place.

For each one:

  1. Find the team that owns the code it changes.
  2. Assign a reviewer from that team, or ping the team in their Slack channel if you are not sure who.
  3. If a reviewer has been assigned for more than a week, nudge them on the pull request or in Slack.

All we ask of the reviewer is a reply: "useful, here's why", "not a fit, here's why", or "leaving it open to see if others want it".

Reddit

Look at r/posthog when you check the other spaces. It's quiet, so this takes a minute. When you see a new post, acknowledge it or reply. If it needs a team, flag it to them in their Slack channel.

How often to check

Two or three times each day is enough.

We aren't alone in these channels:

If we answer nothing for two days, that's fine. We just don't want anything going a week without any interactions, especially if a user seems to be blocked on something.

When to reply

Most of the Discord feed does not need an answer. Have fun with it – there's no PostHog line you need to toe. Be yourself, and talk with the other founders and builders there.

Where to send people

If it's troubleshooting or clarifying how something works, encourage them to ask PostHog AI, as it will have more context around their project. This is the same rule as in community channels.

On the forum, check that the tag is set to the team that owns the product mentioned in the post. The control is below the post, in the moderator tools. The tag puts the thread into that team's support Slack channel, so the team can see it. A tag does not make that team answer. If you want a reply, write in the team's Slack channel too.

If you do not know the answer

Use the answering-community-questions skill in PostHog AI (in the builder relations space). Type /answering and select it, then give it the URL of the thread or the text of the question. It searches our public content, the person's own project data, GitHub, and Slack, and gives you material for your reply. Do not copy and paste a response. Use it to inform what you can say to them, offer troubleshooting advice and help them debug, or help you figure out which team can best help answer the question.

Escalating to a team

Escalate and follow up when a person is truly stuck and cannot continue with their work.

  1. Copy the link to the forum post or the Discord message.
  2. Get the user's email (if on the forum, you can see it in their profile; if in Discord, ask them to DM you).
  3. Create a new support ticket. You can follow a format like this ticket:

Hey there, we just created a ticket for you on behalf of your community post (LINK):

[COPY THE TEXT OF THE POST, OR AT LEAST A QUICK SUMMARY]

We'll take a look and respond here.

Heated topics

Sometimes a group of people disagree with a decision, and the thread gets hot. An example: people want bring-your-own-key, and they are angry that we do not have it.

Do not defend the position yourself. Ask the product owner for that area to write the current thinking in the thread. They know what changed and what is planned. A first-hand answer ends the thread. A second-hand answer extends it.

A hot thread is not an incident. People who disagree with us are still welcome.

Spam, abuse, and hateful content

This is the most urgent thing that tends to happen and needs to be addressed immediately.

Act first, write it down after

If a message contains hateful content, targeted abuse, spam, or leaked credentials, remove it before you do anything else.

Then say what you did in #team-builder-relations.

Ban immediately, or use the ladder

Ban on sight for bad faith:

For anything else, use the four steps in the code of conduct: correction, warning, temporary ban, permanent ban. A first mistake that looks careless starts at correction. A first mistake that looks hostile does not.

Always say why, and how to appeal. Bans and grievances has the mechanics for Discord and for PostHog organizations.

People who help you

Two Discord channels hold members that we selected by hand:

You can rely on these members. They join questions and conversations when they can help.

Routine maintenance

There is almost none, but we may dig into issues if something unexpected happens.

Canonical URL: https://posthog.com/handbook/community/coverage

GitHub source: contents/handbook/community/coverage.mdx

Content hash: 5b5dc52672432946

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