> ## Documentation Index
> Fetch the complete documentation index at: https://taghistory.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tag History Extension

> View and edit tags with a full history timeline — directly on any order, product, or customer page

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

<Note>
  Not sure if the app installed correctly? Open the Tag History app from your Shopify Admin to confirm tracking is active.
</Note>

### 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:

<Tabs>
  <Tab title="Orders">
    <Steps>
      <Step title="Open an order">
        In your Shopify Admin, go to **Orders** and click into any individual order.
      </Step>

      <Step title="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.
      </Step>

      <Step title="Add the Tag History block">
        In the left panel, click **Add block**. Find **Tag** History in the list and click it.
      </Step>

      <Step title="Pin the block (optional)">
        Click **Save**. The block will now appear on all your order detail pages.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Products">
    <Steps>
      <Step title="Open a product">
        In your Shopify Admin, go to **Products** and click into any individual product.
      </Step>

      <Step title="Find the Blocks section">
        In the top-right of the product page, click the **Customize** button (pencil or grid icon). This opens the page layout editor.
      </Step>

      <Step title="Add the Tag Historian block">
        In the left panel, click **Add block**. Find **Tag Historian** in the list and click it.
      </Step>

      <Step title="Pin the block (optional)">
        Click **Save**. The block will now appear on all your product detail pages.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Customers">
    <Steps>
      <Step title="Open a customer">
        In your Shopify Admin, go to **Customers** and click into any individual customer.
      </Step>

      <Step title="Find the Blocks section">
        In the top-right of the customer page, click the **Customize** button (pencil or grid icon). This opens the page layout editor.
      </Step>

      <Step title="Add the Tag Historian block">
        In the left panel, click **Add block**. Find **Tag Historian** in the list and click it.
      </Step>

      <Step title="Pin the block (optional)">
        Click **Save**. The block will now appear on all your customer detail pages.
      </Step>
    </Steps>
  </Tab>
</Tabs>

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

For more on managing app blocks in the Shopify Admin, see .

## Adding a Tag

<Steps>
  <Step title="Open the entity page">
    Navigate to any order, product, or customer in your Shopify Admin
  </Step>

  <Step title="Find the Tag History block">
    Scroll to the Tag History block on the page
  </Step>

  <Step title="Type the new tag">
    Enter the tag name in the input field
  </Step>

  <Step title="Add an optional comment">
    Optionally type a note explaining why you're adding the tag
  </Step>

  <Step title="Click Add">
    Click the **Add** button. The tag is saved to the entity and recorded in the history timeline.
  </Step>
</Steps>

<Info>
  Tag names are case-insensitive for duplicate detection. You can't add a tag that already exists on the entity.
</Info>

## Removing a Tag

<Steps>
  <Step title="Click the tag you want to remove">
    In the current tags list, click on the tag badge
  </Step>

  <Step title="Confirm removal">
    A confirmation dialog appears. Optionally add a comment explaining the removal.
  </Step>

  <Step title="Click Remove">
    The tag is removed from the entity and the change is recorded in history.
  </Step>
</Steps>

## 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)

<Tip>
  Click a user's name in the timeline to open their profile in Shopify Admin.
</Tip>

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

<AccordionGroup>
  <Accordion title="What does &#x22;Shopify Admin&#x22; mean?" icon="circle-info">
    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.
  </Accordion>

  <Accordion title="How do I get user attribution?" icon="user">
    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.
  </Accordion>
</AccordionGroup>

## 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 →](/pricing/premium-plan)