# Leave context the next teammate can find.

What the Shopify order timeline records, how to comment, mention staff and attach files, and how a support team splits the work between comments, order notes, customer notes and tags.

The timeline is the history at the bottom of every order in Orders > [order], with a Leave a comment box for internal staff comments. Type @ to mention a teammate, click the paper clip to attach a file, then click Post.

Source: https://aide.app/guides/shopify-order-timeline · Updated 2026-11-08 · By Ziyad Basheer

| | |
|---|---|
| Visibility | Timeline comments and notes are internal; customers don't see them. |
| Mentions | An @mention emails the teammate; no mention, no notification. |
| Edit window | Edit your own comment for 5 minutes; deleting can't be undone. |
| Order tags | Up to 55 characters each; filter by tag and save a view. |
| Also on | Draft orders, customers and transfers have a timeline too. |

Every Shopify order keeps a running history, and the timeline is where your team talks about it. Used well, the next person who opens order #4831 knows what was promised without asking anyone.

## What the timeline shows

The timeline sits at the bottom of the order details page, in Orders > [order] > Timeline. It records what happened to the order and what staff said about it.

- Payment events. Click one to expand it, then Information from the gateway for the provider's details.
- Order emails sent to the customer, each with Resend email so you can send it again.
- Staff comments, with each author's name and the time posted.

Draft orders, customers and transfers have their own timeline too.

## Add a comment

Comments are the right place for anything a teammate needs to know later.

1. From your Shopify admin, go to Orders and click the order.
2. In the Timeline section, click Leave a comment.
3. Write the comment. Type @ to mention a teammate, or click # to link an order, customer or product.
4. Optional: click the paper clip icon to attach a file, or drag it into the box.
5. Click Post.

A mention emails that teammate, and sends a push notification if they use the Shopify app. With no mention, nobody is notified. You can edit your own comment for 5 minutes after posting.

Attachments are useful for support: a photo of the damaged item, or a picture of the parcel taken before it shipped.

## Notes, comments and tags

Shopify gives you four places to write things down, and each has one job.

- *Timeline comment.* A dated, named post on the order. Use it for the story: what the customer asked, what you did, what you promised.
- *Order note.* One editable field in the order's Notes section (pencil icon to edit). If you've turned on the cart note in your theme, the customer's special instructions land here. Add below their text instead of replacing it.
- *Customer note.* The Customer Note field in Customers > [customer]. It follows the customer to every future order, so use it for lasting facts: "Allergic to latex, never substitute."
- *Tags.* Short labels on orders or customers, such as "replacement-sent" or "VIP". Order tags can be filtered and saved as an order view; customer tags can build customer segments.

All four are internal: Shopify says notes and comments aren't visible to your customers.

## How support teams should use them

Write so a teammate who has never seen the conversation can act. A good comment names the customer's request, the action taken, and the next step with a date.

> Customer emailed about a missing mug. Sent replacement #4902 today, no return needed. If they write again, check tracking on #4902 first.

Then tag the order ("replacement-sent") so the case shows up in a filtered view. Put anything that matters beyond this order in the customer note. To tag and note automatically, see [Shopify Flow for customer service](https://aide.app/guides/shopify-flow), which has Add order tags and Update customer note actions.

## Where Aide helps

Aide keeps the order record and the conversation in step. When a shopper [proves the order is theirs](https://aide.app/shopify/order-verification) and asks for something like "leave it with the concierge", the Aide AI Agent can add it as a note on the order. A procedure can also [tag the order](https://aide.app/shopify/tag-orders-from-support), such as "Do not import" so your fulfillment app holds it back.

Teammates add order notes from the conversation, or from the Aide panel inside Zendesk and Front, without opening Shopify. Each action taken from that panel also leaves an internal note on the ticket, so the helpdesk shows what was done and by whom.

In the other direction, the Aide conversations block on Shopify order and customer pages lists the customer's conversations right in the admin: subject, last activity and status, with a link that opens each one in Aide.

## Frequently asked questions

### Can customers see comments on the Shopify order timeline?

No. Shopify order timeline comments are internal to your store and only staff can read them. The same goes for the order's Notes field and customer notes.

### How do I mention a teammate in a Shopify order comment?

In the order's Timeline, type @ in the Leave a comment box, pick the staff member and click Post. They get an email, plus a push notification if they use the Shopify app, unless they lack access to Orders.

### What is the difference between a Shopify order note and a timeline comment?

An order note is one field per order for messages and special instructions, and a customer's cart note lands there. A timeline comment is a separate, dated post from a staff member, used for internal conversation about the order.

### How do customers add an order note in Shopify?

Turn on the cart note in your theme. In a free Shopify theme, open the theme editor, choose the Cart page, click Sections, select Subtotal and check Enable cart note, then save.

### Where do I add a customer note in Shopify?

Go to Customers, click the customer's name, type in the Customer Note field and click Save. The note stays on the customer profile for every future order and only staff can see it.

### Can I see support conversations on a Shopify order page?

With Aide, yes. Add the Aide conversations app block to your Shopify order and customer pages to list a customer's conversations with their status, each opening in the Aide inbox.

## Set it up
- [Aide in your Shopify admin](https://docs.aide.app/shopify/shopify-admin-app)
- [Shopify orders, shipments and tracking in a conversation](https://docs.aide.app/shopify/orders-in-conversations)

## Related
- [Shopify Flow for customer service](https://aide.app/guides/shopify-flow)
- [How to edit an order on Shopify](https://aide.app/guides/shopify-edit-order)
- [Shopify AI customer service](https://aide.app/integrations/shopify)

Start free: https://my.aide.app/register