Hi,
Is there a GraphQL API mutation to add to an order’s timeline comments? We searched and found Order object has the hasTimeLineComment field, but there doesn’t seem to be any mutations?
There is no mutation that adds timeline comments for now.
As I known, this is read-only.
I would love a way to add some for sure.
That feature has been a request since September 2019 on the old / non-dev forums:
I feel like this is an important feature missing to make sure apps and Flow automations can communicate with the people actually working on orders and to provide some transparency.
And as this is not a question if this is possible, but a feature request, the “solved” status feels disingenuous.
Similar topics:
Bump again because somehow after all this time this still doesn’t exist. This topic is NOT solved. We need to be able to add an order timeline comment from GraphQL.
bumping again because this doesnt exist still
crazy still cant adda timeline comment via api. we have made custom app block isntead for now
+1 from a merchant running order-processing automation in production (Hungarian furniture store).
Our automation handles routine order processing end-to-end: supplier purchase orders, fulfillment-status updates, tracking links, customer notifications. For every action it takes we need an audit entry on the order that staff actually see — which is exactly what the Timeline is for. Our staff also assign tasks to each other with @mentions in Timeline comments, and the automation cannot participate in that channel at all.
Because no commentEventCreate-style mutation exists, we had to build a two-part workaround: the full timestamped machine log goes to a pinned order metafield, and the order note carries a single short “last operation” line, carefully merged so we never clobber human-entered notes. It works, but it’s strictly worse than a Timeline comment: the note field wasn’t designed for concurrent writers, metafields notify nobody, and neither supports @mentions. Meanwhile the Timeline already shows app events (“app edited the note”) — the surface exists, apps just can’t post to it.
Request: a scoped mutation (e.g. orderCommentCreate, gated behind its own access scope) with the app clearly labeled as the author. Attribution addresses the abuse concern, and the scope keeps it opt-in per app.
This has been requested since 2019 and Shopify staff confirmed in Nov 2025 that it’s logged as a feature request — would love to see movement on it.