What Is the Extension?
The Tag History extension is an admin block that appears on individual order, product, and customer pages in your Shopify Admin. It lets you:- See all current tags on the entity
- Add or remove tags (with an optional comment)
- View a full timeline of every past tag change
Setting Up the Extension Blocks
The Tag History block is automatically added to your order, product, and customer pages when you install the app. If you can’t see it, you may need to add it manually through Shopify’s page customisation interface.Not sure if the app installed correctly? Open the Tag History app from your Shopify Admin to confirm tracking is active.
Finding the block
After installation, open any order, product, or customer detail page in your Shopify Admin and scroll down. The Tag History block appears in the right-hand column or lower body of the page.Adding the block manually (if it’s not showing)
If the block doesn’t appear, follow these steps for each page type:- Orders
- Products
- Customers
1
Open an order
In your Shopify Admin, go to Orders and click into any individual order.
2
Find the Blocks section
In the top-right of the order page, click the Customize button (pencil or grid icon). This opens the page layout editor.
3
Add the Tag History block
In the left panel, click Add block. Find Tag History in the list and click it.
4
Pin the block (optional)
Click Save. The block will now appear on all your order detail pages.
Adding a Tag
1
Open the entity page
Navigate to any order, product, or customer in your Shopify Admin
2
Find the Tag History block
Scroll to the Tag History block on the page
3
Type the new tag
Enter the tag name in the input field
4
Add an optional comment
Optionally type a note explaining why you’re adding the tag
5
Click Add
Click the Add button. The tag is saved to the entity and recorded in the history timeline.
Tag names are case-insensitive for duplicate detection. You can’t add a tag that already exists on the entity.
Removing a Tag
1
Click the tag you want to remove
In the current tags list, click on the tag badge
2
Confirm removal
A confirmation dialog appears. Optionally add a comment explaining the removal.
3
Click Remove
The tag is removed from the entity and the change is recorded in history.
Reading the History Timeline
Below the current tags, the timeline shows every past change in reverse chronological order. Each entry shows:- Time — when the change was made (e.g., “5m ago”, “2h ago”, “Jan 5”)
- Who — the user name if changed via Tag History, or “Shopify Admin” if changed elsewhere
- What changed — tags with a
+prefix were added, tags with a−prefix were removed - Comment — any note left by the user (Premium)
User Attribution
Changes made through the Tag History extension show the name of the logged-in user. Changes made elsewhere (via Shopify’s native tag field, other apps, or bulk edits) appear as “Shopify Admin” since Shopify does not tell us who made them.What does "Shopify Admin" mean?
What does "Shopify Admin" mean?
It means the tag was changed outside of the Tag Historian extension — through Shopify’s own interface, another app, a CSV import, or the API. We detected the change but can’t determine which user made it.
How do I get user attribution?
How do I get user attribution?
Use the Tag Historian extension block to add or remove tags instead of Shopify’s native tag field. Both result in the same tag being saved — the difference is whether attribution is captured.