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


PostHog can capture frontend events automatically using autocapture. This means you do not need to manually instrument tracking for individual components, links, buttons or other parts of your product to get started at analyzing user behavior. Autocapture is available for our JavaScript snippet , JavaScript SDK , React SDK , and React Native SDK . Capturing additional properties in autocapture events If you add a data attribute onto an element in the format data-ph-capture-attribute-some…

Read next article