Test Mode
Learn how to set up and use Test Mode to debug your analytics setup.
Using Test Mode
Overview
Test Mode allows you to simulate the behavior of your analytics setup without actually dispatching events to their configured destinations. This is useful for debugging, validating integrations, and ensuring everything works as expected before going live.
Two Ways Of Using Test Mode
No Code:
- Navigate to the Interactive Studio page in your dashboard.
- Enter the URL of your website or app, and submit the form
Entering test mode

Seeing events show a toast message popup in the lower corner of the screen

Via Code: Install a Test Mode Token:
You can use your test token via GTM, the Web SDK, or any Ingest Server API with a test token. This will force all events to be in test mode until you deploy with a live token.
How Test Mode Works
-
Event Storage:
- All events sent using the Test Mode token are stored in your dashboard.
- These events simulate dispatches, meaning dispatch objects are created but are not sent to the destinations.
-
Dashboard View:
- Events processed in Test Mode will appear in your Recent Events view with a distinct visual indicator (e.g., a "Test" tag).
Debugging and Validation
-
Trigger Events:
- After setting up the Test Mode script or token, trigger events on your site or application.
-
Review in Dashboard:
- Go to the Recent Events view to see the captured events.
- Events tagged with "Test" confirm that they are being processed correctly without being dispatched to destinations.
-
Live Token Validation:
- Once you've verified your setup in Test Mode, switch to the live token to ensure events are sent to their intended destinations.
Key Features of Test Mode
- Events are fully processed and saved.
- Dispatches are created but not executed, ensuring no data is sent to external destinations during testing.
- A dedicated visual marker in the dashboard differentiates Test Mode events for clarity.
Benefits
- Debug and validate your analytics setup in a controlled environment.
- Ensure configurations are correct without impacting live data or external systems.
Updated 18 days ago