Skip to main content

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
You don’t need to leave the page or open a separate app — the history is right there in context.

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:
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.
The Customize button only appears on individual detail pages — not on list views like the Orders or Products list. Make sure you’ve clicked into a specific order, product, or customer first.
For more on managing app blocks in the Shopify Admin, see .

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)
Click a user’s name in the timeline to open their profile in Shopify Admin.

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.
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.
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.

Usage Limit Warning

If you’re on the Free plan and have reached your 30 changes/month limit, the extension will show a warning banner. You can still view history, but new tag changes will not be recorded until the 1st of next month (or until you upgrade to Premium). Upgrade to Premium →