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

# Troubleshooting

> Solutions to common issues with Tag History

## Tag History Not Appearing

<AccordionGroup>
  <Accordion title="The Tag History block doesn't appear on entity pages" icon="eye-slash">
    The extension block may be hidden in your Admin layout.

    1. Open an order, product, or customer page in Shopify Admin
    2. Click **Customize** (or the pencil icon) to edit the page layout
    3. Look for the Tag History block and make sure it's set to visible
    4. Save the layout

    If the block doesn't appear in the list at all, try refreshing the page or reinstalling the app.
  </Accordion>

  <Accordion title="History is empty even after changes were made" icon="database">
    A few possible reasons:

    * **Changes were made before installation** — Tag History only records changes that occur after it's installed
    * **Tracking is disabled for that entity type** — Check Settings to confirm orders/products/customers are enabled
    * **Free limit reached** — If you hit the 30-change monthly limit, new changes stop being recorded. Check the dashboard usage card.
  </Accordion>
</AccordionGroup>

## User Attribution Issues

<AccordionGroup>
  <Accordion title="All changes show Shopify Admin and no user names" icon="user-slash">
    User attribution is only captured when tags are changed through the Tag History extension block. If your team is using Shopify's native tag field, those changes will show as "Shopify Admin."

    To get user attribution, instruct your team to use the Tag History block for tag edits.
  </Accordion>

  <Accordion title="A change shows the wrong user" icon="user-pen">
    Tag History uses the identity of the logged-in Shopify Admin user at the time the change is made. If a team member was logged in as someone else, the wrong name may appear. This is a Shopify session issue rather than an app bug.
  </Accordion>
</AccordionGroup>

## Usage and Limits

<AccordionGroup>
  <Accordion title="I've run out of changes but the month just started" icon="calendar-xmark">
    Each tag addition or removal counts as one change. If tags are being added or removed in bulk (e.g., by automation, another app, or Shopify Flow), you can hit the 30-change limit quickly. Check your dashboard to see recent activity.

    Upgrade to Premium for unlimited tracking.
  </Accordion>

  <Accordion title="The usage counter isn't resetting on the 1st" icon="rotate-left">
    Usage resets at midnight UTC on the 1st of each month. If it's past the 1st and your counter hasn't reset, try refreshing the dashboard. If the issue persists, contact support.
  </Accordion>
</AccordionGroup>

## Billing and Subscription

<AccordionGroup>
  <Accordion title="I upgraded to Premium but features are still locked" icon="lock">
    Try refreshing the page. If Premium features are still locked after a minute, try logging out of Shopify Admin and back in. If the issue persists, contact support with your store domain.
  </Accordion>

  <Accordion title="The Upgrade button isn't working" icon="credit-card">
    The upgrade flow opens a Shopify billing confirmation page. If nothing happens when you click **Upgrade to Premium**, try:

    * Disabling any popup blockers in your browser
    * Using a different browser
    * Logging out and back into Shopify Admin

    If still not working, contact support.
  </Accordion>

  <Accordion title="I can't find the option to downgrade" icon="circle-down">
    Go to **Settings** and find the **Your Plan** section. If you're on Premium, the Free plan card will show a **Downgrade** button.
  </Accordion>
</AccordionGroup>

## CSV Export

<AccordionGroup>
  <Accordion title="The Export CSV button is greyed out" icon="file-csv">
    CSV export is a Premium feature. Upgrade to Premium to unlock it.
  </Accordion>

  <Accordion title="The CSV downloaded but it's empty" icon="file-slash">
    This can happen if no tag changes have been recorded yet. Check the dashboard to confirm there is history. If history is visible but the export is empty, contact support.
  </Accordion>
</AccordionGroup>

## Still Stuck?

<CardGroup cols={2}>
  <Card title="FAQ" icon="circle-question" href="/support/faq">
    Browse common questions
  </Card>

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