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

# Installation

> Install Tag History from the Shopify App Store

## Prerequisites

## Installation Steps

<Steps>
  <Step title="Visit the App Store">
    Go to the [Tag History app listing](https://apps.shopify.com/tag-history) in the Shopify App Store
  </Step>

  <Step title="Click Install">
    Click the **Add app** button on the listing page
  </Step>

  <Step title="Review Permissions">
    The app requests access to read and write orders, products, and customers. This is required to track tag changes and allow editing tags through the extension blocks.
  </Step>

  <Step title="Authorize Installation">
    Click **Install app** to confirm. You'll be redirected to the Tag History dashboard inside your Shopify Admin.
  </Step>
</Steps>

<Info>
  Installation takes less than a minute. The app starts tracking tag changes as soon as it's installed.
</Info>

## Onboarding

After installation, Tag History walks you through a short onboarding flow that:

* Syncs your inital product, order and customer tag data for a baseline
* Shows you how to add the Tag History block on your order, product, and customer pages
* Get the most out of the audit trail

You can skip the onboarding at any time and return to the dashboard.

## What Happens After Installation

Once installed, the app:

* Registers webhooks to automatically detect tag changes on orders, products, and customers
* Adds the **Tag** History block to your Admin UI extensions (visible on individual order, product, and customer pages)
* Begins recording all tag additions and removals

<CardGroup cols={2}>
  <Card title="View the Dashboard" icon="chart-line" href="/features/dashboard">
    See store-wide tag activity
  </Card>

  <Card title="Use the Extension" icon="sidebar" href="/features/tag-history-extension">
    Edit and view tag history on any entity page
  </Card>
</CardGroup>

## Uninstalling the App

<Warning>
  Uninstalling Tag History permanently deletes all stored tag history for your store. Export your data first if you need to keep it.
</Warning>

<Steps>
  <Step title="Go to Apps Settings">
    In your Shopify Admin, go to **Settings** → **Apps and sales channels**
  </Step>

  <Step title="Find Tag History">
    Locate Tag History in your installed apps list
  </Step>

  <Step title="Uninstall">
    Click the **...** menu and select **Uninstall**
  </Step>
</Steps>

All data (tag history, comments, usage records) is deleted immediately upon uninstall.

## Need Help?

<CardGroup cols={2}>
  <Card title="How It Works" icon="book" href="/how-it-works">
    Understand what gets tracked and how
  </Card>

  <Card title="Contact Support" icon="envelope" href="/support/contact">
    Get help from our team
  </Card>
</CardGroup>