Mark events with annotations

An annotation is a note pinned to a moment, or a stretch of time, that shows up on every chart. Mark the day you ran a giveaway, the evening of a raid or the week of a big update, and a spike on any chart explains itself.

Annotations come with Pro and Titan; rules come with Titan. The toolbar button Annotations on charts shows or hides markers on every chart.

Add an annotation

You need permission to edit annotations, which the Manager and Admin roles have; see Give your team access.

From a chart:

1. Open a chart full screen and press the moment you want to mark.
2. Give it a title and, if you like, a note.
3. Press Add annotation.

From the timeline:

1. Open Annotations, then Timeline, and press New annotation.
2. Write what happened, and set the date and time. The time is in your server's time zone.
3. For something that lasted, such as a weekend event, press Add an end time. The end must come after the start.
4. Press Save in the bar at the bottom of the page. You can make several changes and save them together, or press Discard to drop them.

A title can be up to 200 characters and a note up to 2,000. A server can hold 1,000 annotations added by hand.

How annotations appear

A single moment shows as a marker under the chart; something that lasted shows as a shaded band. Hover or focus a marker to read its title, time and note. Press it to edit it or Delete it.

Timeline lists every annotation by month, newest first, for the date range you pick. On plans with Pulse, each one also says whether messages, voice or joins moved in the days after it.

Let rules mark the timeline

A rule watches one channel and adds an annotation whenever something is posted there. Point one at your announcements channel and every announcement lands on your charts without anyone lifting a finger. A rule notices only that a message was posted, never what it says.

1. Open Annotations, then Rules, and press New rule.
2. Pick the channel.
3. Write the title each mark will carry. Variables lists what you can fill in: the channel's name, the number of messages, and the date and time.
4. Optionally add a note.
5. Choose from now on, or from earlier posts to mark posts from up to 30 days back. The option shows how many marks that would add.
6. Press Save.

Marks made by a rule carry a Rule badge. Rules check for new posts every few minutes, so a mark can take a little while to appear. Each rule can be switched between Enabled and Disabled, duplicated or deleted, and a server can have up to 200 rules.

Every server also has one built-in rule for Discord scheduled events, which marks each event under its own name. It can be switched off, but not edited or deleted.