Last updated:

Annotations allow you to leave notes on your charts that can help you understand the driving factors behind the changes that happen over time.

You can use annotations to mark things like version releases and new blog posts, which helps you add helpful context on events that impacted your metrics.

Why Annotations are useful

The chart below shows a large spike in website traffic, which has been annotated to explain why that spike occurs. Annotations can be viewed by hovering over them.

PostHog Annotations

Annotations can be written after the fact, which makes them useful for future reference, or before an event if you want to analyze the future impact of a particular marketing initiative, for example.

Creating an Annotation

When editing a chart in Trends, Sessions or in a Dashboard, hover your cursor over the dates at the bottom of the chart to reveal a button with a + symbol. Clicking it will then open up a modal where you can create your Annotation, as well as choose to have it specifically for the current chart or all of your charts.

With your annotation created, it will now be available at the bottom of your chart, and you can also view all of your existing annotations in /annotations.


Was this page useful?

Next article


Cohorts are PostHog's way of letting you easily create a list of users who have something in common. You can use the cohorts to: View a list of users who all did the same action or have the same property. A few examples of how you might use this are: "Which users used the app today?" "Which users work at the same company?" "Who used the app once but never came back?" Segment other statistics. For example, to view user paths or action trends. This let's you understand things like: "Are people at…

Read next article