SEO and marketing

Search Console annotations: log every change to your website

By Edgar Jaimes 3 min read

Open monthly planner with a cup of coffee on top and notes of the month's goals

Search Console annotations let you mark every change to your website on the performance chart. How to create them, their limits and what to note.

One Monday you open Search Console and your clicks have dropped by half compared to last week. You know something happened, but you don't remember whether it was the redesign of your services page, the new plugin or just a holiday. Without a note, your memory is the only record.

Custom annotations solve exactly that: they leave the explanation written on the chart itself. Google introduced them on its Search Central blog and today you can use them on any property.

What are Search Console annotations?

They are dated notes that appear on the performance report chart. According to the Search Console help page, there are two types: system annotations, which Google generates on its own to flag data processing and reporting issues, and custom ones, which you write yourself to mark events specific to your site.

They help you read your numbers better. If you also measure visits and leads in GA4, combine them with UTM parameters and with the key events worth measuring.

Wall with yellow sticky notes arranged in columns on a board
A dated note is worth more than remembering what you changed. Photo: Unsplash

How do I create an annotation?

Right-click the date on the performance report chart, write the note and click “Add”. According to Google, the text can be up to 120 characters and the annotation stays as a marker on that date.

To delete it, click the marker, choose delete and confirm. One catch: the help page says they can't be edited for now. If you make a mistake, delete it and create another.

What limits and permissions do they have?

Each property supports up to 200 annotations, and those older than 500 days are deleted automatically. This is the data Google publishes:

AspectWhat the Search Console help page says
LengthUp to 120 characters per note
QuantityUp to 200 per property
DurationAutomatically deleted after 500 days
Owners and full usersCan add, view and delete
Restricted usersCan only view them
EditingNot available for now

Annotations show with any filter, but not in comparison mode or in the 24-hour view.

Heads up: annotations are visible to anyone with access to the property. Google recommends not writing personal data in them, such as names, phone numbers or addresses. Describe the change, not the person.

What should I note?

Note everything that could move your clicks, impressions or position. Google's blog gives four examples of useful events:

  • Infrastructure changes: updating a template or migrating the site.
  • SEO efforts: installing a new plugin or hiring an agency.
  • Content changes: refocusing pages on a different search intent.
  • External events: a holiday or another event that affects your business.

Add whatever is specific to your site: the publication of an important guide, a change of titles and meta descriptions or a large-scale 301 redirect. An example of a short note: “Migration to new domain, redirects active”.

Hand writing a checklist with checkboxes in a squared notebook
A short list of changes with their dates is the best history of your site. Photo: Unsplash

How do I use annotations to diagnose a drop?

Match the date of the change with the date the curve moved. If the drop starts right after an annotation, you have a concrete lead to check. If it coincides with a Google update, the cause is probably something else: see our guide on the November 2026 core update. And if a page stopped appearing, check the not-indexed page statuses.

Common mistake: noting only when something goes wrong. Also note the changes that went well: that way you'll know what to repeat.

In short

That Monday with clicks cut in half stops being a mystery when every important change was marked on the chart. Take a minute to create the annotation every time you touch your website. If you want us to organize your site's SEO and keep every change measured, check out our SEO and GEO service.

Frequently asked questions

What are annotations in Search Console?

They are dated notes that appear on the performance report chart. According to Google, system annotations flag data processing issues and custom ones are created by you to mark events on your property.

How many annotations can I create and how many characters can each have?

According to the Search Console help page, each property supports up to 200 annotations and each note can have up to 120 characters.

Who can create or delete annotations?

Owners and full users can add, view or delete any annotation. Restricted users can only view them.

Can I edit an annotation after creating it?

Not for now. According to Google's help page, editing is not available: if you make a mistake, delete the annotation and create a new one.

How long are annotations kept?

Google automatically deletes them when they are more than 500 days old.

Do not stop at the theory: apply it to your business

We implement SEO and GEO with AI end to end, with your real operation. The first conversation is free.

Keep reading