Shopify Analytics Annotations: How Merchants Can Add Context to Their Store Data

A report can show that sales dipped on a Tuesday, or that conversion rose in the second week of November. It can't show that you changed supplier that week, or that a creator mentioned your product.

Since October 1, 2026, Shopify Analytics lets merchants add that context themselves. You can place your own annotations on a report's timeline, next to the data they relate to. This guide covers what changed, what you can record, where the limits are, and how to use annotations for BFCM.

What Are Shopify Analytics Annotations?

Shopify describes annotations as "visual markers on your reports at the dates when events occurred". They appear as color-coded markers and dots on charts that have a time axis. Hover over a marker to see that day's activity, or click it to open the annotations panel.

Annotations come from three sources:

What Shopify Changed in October 2026

Annotations themselves aren't new. Shopify first introduced automatically generated annotations in May 2026, covering store activity and system events.

On October 1, 2026, Shopify expanded Analytics annotations so merchants and their staff can add their own business context directly to supported time-series reports. Its announcement puts it simply: "Your reports show what changed. You know why."

From the annotations panel you can now:

• Add a title, description, date or date range, and annotation type.
• Use a category Shopify suggests, or choose your own.
• Edit and delete annotations, and see who created each one.
• Search and filter context from your team, installed apps and Shopify.

Why Analytics Data Needs Business Context

Reports are good at "what". They're poor at "why".

Shopify's Help Center says it directly: "Metrics on their own represent what's happening with your business, but including annotations in a report can help you investigate why things are happening."

Before this, the "why" usually lived somewhere else. Shopify's own list is accurate: "memory, spreadsheets, or team threads". That works for a week. Six months later, when someone asks why March looked unusual, nobody remembers that a free shipping threshold changed.

Shopify's automatic annotations help here too. They mark metric definition changes, so a shift caused by Shopify's reporting, like the one covered in our guide to the September 2026 analytics changes, can be told apart from a shift caused by your business.

What Can You Add to an Annotation?

To create one, open a report under Analytics > Reports, click Annotations, and create a new annotation. It can also be done in the Shopify mobile app.

Categories are grouped into Product, Online store, Marketing, Discounts & pricing, Inventory & fulfillment, Operations, and Other.

One useful detail: an annotation isn't tied to the report you created it in. Shopify says staff annotations display on any report that includes annotations for the same dates and activity type.

Practical Examples for Shopify Merchants

A good title says what changed in plain words. "Promo" won't mean anything in six months. "Free shipping over $50 starts" will.

How to Use Annotations During BFCM

Peak season is when the most things change at once, which makes it the hardest period to read afterwards. Annotating as you go fixes that.

Events worth recording:

• Campaign launch, with a date range covering the whole sale.
• Discount launch, and any change to the offer partway through.
• Major email sends, using the optional time field.
• Influencer or creator campaigns.
• Product launches and bundle launches.
• Theme changes. Shopify can automatically record a theme publication, while your own annotation can explain what changed and why. If you're redesigning with Shopify Canvas, record when the new theme went live.
• Shipping changes, such as a new threshold or cut-off date. Stores affected by market-driven shipping should note when their shipping setup changed.
• Inventory changes, such as a best seller going out of stock.

After the event, open your sales, sessions or conversion reports with annotations shown. You can then see which changes lined up with which movements, day by day, instead of looking at one large spike. Next year's planning starts from a record, not from recollection. Our BFCM product page checklist covers the changes most worth tracking.

How Annotations Help Ecommerce Teams Work Together

Shopify says annotations are "shared with staff who have Reports permission" and appear alongside context from Shopify and installed apps, creating "one shared history of what changed".

In practice, that means:

• Marketing and operations see the same timeline. A marketing manager can see that a warehouse change happened during their campaign.
• Each annotation shows who created it.
• You can search by keyword, and filter by activity type or by creator: Shopify, staff or apps.

Two things to know before a team starts using them. Anyone with the Reports permission can edit or delete annotations created by other staff. And apps that have access to your store's annotations can read the ones your staff create, including titles, descriptions, dates and types, though not the name of the person who created them.

What Shopify Analytics Annotations Don't Tell You

Annotations are notes, not analysis.

• They don't prove cause. A marker next to a spike is a reason to investigate. Two events on the same day can't be separated by a note.
• They aren't automatic analysis. Shopify suggests a category, but the content is whatever your team writes.
• They're short. With 75 characters for a title and 150 for a description, they point to an event. They don't replace a campaign report.

Shopify also documents these limits:

• Annotations need time to be the first dimension in the report.
• Donut charts, tables and cohort grids don't display them.
• They aren't included in report exports.
• They aren't available for multi-store reports.
• Shopify's automatic annotations appear only for stores that average 10 or more orders a week for at least 12 non-consecutive weeks in the past 6 months, with at least 1 order in the past 2 weeks.

A Simple Workflow for Using Annotations

1. A business event happens, or is scheduled.
2. Add the annotation the same day, with a clear title and category.
3. Let the data come in.
4. Review the metric with annotations shown.
5. Compare the event with performance, and check what else was annotated that day.
6. Record what you learned.
7. Use it for the next campaign.

The second step is the one that fails. An annotation added weeks later relies on the same memory it was meant to replace.

Who Should Use Shopify Analytics Annotations?

• Small stores. A handful of notes a month replaces the owner's memory.
• Growing ecommerce teams. Marketing, merchandising and operations share one timeline.
• Shopify Plus teams. More people and more changes make the record more valuable. Note that multi-store reports don't support annotations.
• Agencies and store managers. A history that survives handovers and staff changes.
• Marketing teams. Campaigns, ad spend changes and collaborations.
• Operations teams. Supplier, warehouse, fulfillment and returns changes.

Shopify's documentation doesn't state a plan requirement for annotations. Access depends on the Reports permission.

What Shopify Merchants Should Do Now

These are our recommendations, not Shopify requirements:

• Turn on annotations in the reports you check most.
• Check who has the Reports permission, since that controls who can add, edit and delete.
• Agree a naming convention, so titles are consistent across the team.
• Give one person responsibility for adding annotations during campaigns.
• Annotate your planned BFCM events as each one goes live.

Conclusion

Shopify Analytics annotations don't change your numbers. They change how easily you can read them later. By recording campaigns, pricing changes and operational changes beside the data, a team keeps a shared history of what it did and when.

If your Shopify store needs deeper analytics, custom storefront improvements or integrations around Shopify's evolving platform, AD Digitech can help evaluate the right approach.