> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mention-me.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Debug Dashboard

> How to use the Debug Dashboard to check data is flowing correctly into Mention Me and troubleshoot integration issues.

The Debug Dashboard helps you check that your data is flowing correctly into Mention Me. It gives visibility of orders, customer details, and any issues that may need fixing. Data is retained for **30 days**.

## Why Use the Debug Dashboard?

* Confirm your orders and customer details are being received
* Spot issues like missing data or duplicate orders
* Share examples with your Mention Me contact if something looks wrong

## Accessing the Debug Dashboard

Find the Debug Dashboard under **Settings & Tools > Tools > Debug Dashboard**, or search for "Debug Dashboard" in the search bar.

<Frame caption="Debug Dashboard location in Settings and Tools">
  <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/tags/30197763414045.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=45d042ce944588a5aa465d5ad12c1879" alt="Debug Dashboard location in Settings and Tools menu" width="1324" height="911" data-path="images/knowledge/tags/30197763414045.png" />
</Frame>

## What Is Debug Mode?

By default, the Debug Dashboard refreshes on a short delay. Clicking **Enable debug mode** (at the top of the dashboard) switches it to real-time monitoring, so you see tag data the moment it's received — useful when you're actively testing and want instant feedback rather than waiting for the next refresh.

Debug mode also matters if you're testing tags on your **live** site before your integration is approved to go live: without it enabled, live tag requests can return a `403 Forbidden` response. See [Testing Your Integration](/developer-docs/integration/setup/testing#debug-mode) for the full testing workflow.

## At a Glance

The top of the dashboard gives you a quick health check:

* **Found**: All records received
* **Valid**: Records successfully processed
* **Duplicate orders**: Orders sent more than once (e.g. duplicate tag firing)
* **Warnings**: Data was accepted, but something is missing or unusual
* **Errors**: Data could not be processed (requires attention)

Most of your data should appear as **Valid**. A few warnings are normal. Lots of duplicates or errors may suggest a setup issue.

<Frame caption="Summary stats: Found, Valid, Duplicates, Warnings and Errors">
  <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/tags/30197798109597.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=66c38ea157d78739fbea8ac2ab55d3e8" alt="Debug Dashboard summary stats bar" width="785" height="184" data-path="images/knowledge/tags/30197798109597.png" />
</Frame>

## Exploring the Data

Beneath the summary stats are "Top 5" lists showing the most common data sources:

* **Transactions**: Currencies of received orders
* **Sources**: How data reached Mention Me (e.g., tag, webhook, API)
* **Situations**: Where the tag fired (e.g. thank-you page)
* **Tag types**: What kind of tag (order, referral, dashboard)
* **Locales**: Site or language the data came from

<Frame caption="Top 5 lists for transactions, sources, situations, tag types and locales">
  <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/tags/30197763416349.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=fce67543558750f0389ecd11a49d0038" alt="Debug Dashboard Top 5 lists" width="1354" height="847" data-path="images/knowledge/tags/30197763416349.png" />
</Frame>

## Filtering the Debug Dashboard

Use filters at the top of the dashboard to focus your view:

* **Search bar**: Search by order ID, email, etc.
* **Has warnings?**: Filter records with warnings
* **Parameter filters**: Filter on situation, locale, currency, type, etc.
* **Clear filters**: Reset all filters for a full view

<Frame caption="Debug Dashboard filter controls">
  <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/tags/30197763416733.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=96e7011716ef112021415ed49bcf0b13" alt="Debug Dashboard filter controls" width="1090" height="617" data-path="images/knowledge/tags/30197763416733.png" />
</Frame>

### When to Use Filters

* **Troubleshoot errors**: See if errors come from a specific situation (e.g., postpurchase)
* **Validate a campaign**: Check that data is being received from the right source
* **Investigate warnings**: Look for patterns
* **Check a case**: Search by known values like email or order ID

## Looking at Individual Records

Click a row to expand details:

* **Customer**: Email, ID, and name
* **Transaction**: Order and purchase details
* **Triggers**: Locale, situation, segment, and type (e.g., popup, embed)

<Frame caption="Expanded record showing customer, transaction and trigger details">
  <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/tags/30197763418269.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=ae1101c8d1883fe952a725109e73189c" alt="Debug Dashboard expanded record" width="1096" height="852" data-path="images/knowledge/tags/30197763418269.png" />
</Frame>

If everything shows as green (Valid), no action is needed.

## What to Do If You Spot Issues

* **A few warnings**: Normal, no action needed
* **Lots of duplicate orders**: Check your <a href="https://demo.mention-me.com/api-demo/v2/generic/instructions/referrer/postpurchase/popup" target="_blank" rel="noopener noreferrer">postpurchase tag</a> or your <a href="https://developers.mention-me.com/reference/post_api_order" target="_blank" rel="noopener noreferrer">order API</a> integration
* **Errors**: Note the affected rows and share them with the Mention Me team or submit via the [Help with Tech form](https://help.mention-me.com/hc/en-gb/requests/new?ticket_form_id=8840645829405). Include the page URL with filters applied.

## Empty Values

Empty values aren't always a concern:

* A landing page referral tag may not capture data until the form is completed
* A transaction total marked as "empty" might just be a dispatch update, not a real order

<Frame caption="A debug dashboard record showing empty values that are not necessarily a concern.">
  <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/tags/30197763418909.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=6a2da62d4025bdf0825af4ce5c97d72b" alt="Debug Dashboard record with empty values" width="1054" height="309" data-path="images/knowledge/tags/30197763418909.png" />
</Frame>

These may appear as errors but are often just warnings.

<Frame caption="Empty values appearing as errors in the debug dashboard, though they are often just warnings.">
  <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/tags/30197763419549.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=72db4b9b17673e6ddd39b68978fcaecd" alt="Debug Dashboard empty values appearing as errors" width="1084" height="904" data-path="images/knowledge/tags/30197763419549.png" />
</Frame>

## Undefined Values

**Undefined** means the data should be there but isn't. This may indicate a problem with your data layer. Confirm you're referencing the correct object or variable to pull values into the tag.

<Frame caption="A debug dashboard record showing undefined values that may indicate a data layer issue.">
  <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/tags/30197763419805.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=5bb608cf6a29f8e6209d8b06429eaf7a" alt="Debug Dashboard record with undefined values" width="1087" height="876" data-path="images/knowledge/tags/30197763419805.png" />
</Frame>

Always investigate undefined customer details or attributes like situation or locale. These are critical for ensuring users see the correct referral offer.

<Frame caption="A warning for undefined customer details shown in the debug dashboard.">
  <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/tags/30197763420189.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=20105bad6d8f5d6c0a7d831da683b69c" alt="Debug Dashboard undefined customer details warning" width="608" height="323" data-path="images/knowledge/tags/30197763420189.png" />
</Frame>

## Help with Problem Logs

If you see an issue, raise a ticket using the [Help with Tech form](https://help.mention-me.com/hc/en-gb/requests/new?ticket_form_id=8840645829405). Include filtered URLs, specific tag names or order IDs, screenshots, and steps to reproduce the problem.
