It’s finally here: How to add custom annotations in Google Search Console (Tutorial)

Does this sound familiar? You’re looking at your performance report, you see a massive traffic spike (or drop) from three months ago, and you ask yourself: “What on earth did we actually do that day?” Was it the relaunch? A Google update? Or the Black Friday campaign?

Since November 17, 2025, the guesswork is over. Google has officially rolled out Custom Chart Annotations in Google Search Console (GSC). Yes, you heard that right! You can now add your own notes directly to your charts. This is pure gold for your SEO analysis.

In this article, you will learn how the new feature works, what the limits are, and how to use it strategically.

Custom Chart Annotations are user-defined text notes that you can place directly on the timeline of your performance report for a specific date.

The macro context here is crucial: it’s about linking data with events. Previously, Google only set automatic annotations (e.g., for Core Updates). Now, you are in control. When you hover over the date, your note is displayed. This feature helps you and your team immediately identify the cause and effect of traffic changes within the tool, without having to sift through external Excel sheets.

Annotations provide instant context for complex data trends and prevent misinterpretations.

Imagine you’re working in a team or with an agency. A colleague sees a drop in clicks and starts to panic. Thanks to an annotation, they immediately see: “Ah, that was the day of the server migration.” This saves time and nerves. Fact-based information increases the authority of your analysis.

Advantages at a glance:

• Centralization: All info is in one place (Single Source of Truth).
• Team Communication: All users of the property can see the notes.
• Long-term Memory: You’ll never forget exactly when that title tag test started.

Setting it up is quite simple, but you need to know where to click. Follow these steps to create your first note:

1. Open your Google Search Console and navigate to the “Performance” report.
2. Hover your mouse over the date in the chart that you want to comment on.
3. Click (depending on the browser, right-click or left-click on the plus icon) on the option “Add annotation”.
4. Type your text into the field (e.g., “Start Relaunch Category X”).
5. Save the annotation to make it visible to all users.

By following this clear structure, you ensure that the note is correctly saved in the system.

Before you start logging your lunch every day: there are technical limits. Entities like “Annotations” have specific attributes and values you should know.

Here are the hard facts:

• Character Limit: You have a maximum of 120 characters per note. Keep it brief!
• Quantity: A maximum of 200 annotations are possible per property. Use them wisely.
• Lifespan: Annotations remain stored for 500 days. After that, they are automatically removed.
• Visibility: Every note is visible to all users of the property (including clients!).

Avoid opinion-based statements in the notes (like “That was a bad update”); instead, stick to fact-based information (e.g., “Update rolled out v1.2”).

Not every event deserves an annotation. To maintain clarity and stay within the 200-limit, you should focus on events that can significantly impact organic traffic.

Here are the most important use cases:

• Technical Changes: Server migrations, relaunches, changes to the URL structure, or implementation of Structured Data.
• Content Updates: Publishing large content clusters, massive overhauls of old articles, or adjustments to meta data.
• External Factors: Launch of TV campaigns (brand searches increase), seasonal events like Black Friday, or known Google Updates (if Google hasn’t marked them itself).
• Offline Events: Issues with product availability or website downtime.

By documenting these points, you can later provide evidence for why the curve went up or down.

Custom Chart Annotations are a long-overdue tool that makes your SEO analysis more professional and efficient.

It is important to remember that data without context is often worthless. With this update, Google finally gives us the opportunity to write our “SEO history” directly within the data tool. Use the feature with discipline for truly important milestones.

You can find more technical details in the official Google blog post: Custom Chart Annotations in Search Console.

Your next steps:
Log into your GSC now and create your first note for the last major change you made to your site. This way, you start directly with clean documentation!