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

# PureClarity Debug Toolbar

> Complete guide to using the PureClarity Debug Toolbar for testing, previewing, and debugging campaigns, zones, and events

The PureClarity Debug Toolbar is an essential development tool that enables you to preview, test, and debug PureClarity implementations directly on your website.

## Toolbar Capabilities

### Core Functions

**Zone Management:**

* View all zones present on current page
* Check zone rendering status and results
* Locate zones visually on the page

**Content Preview:**

* Preview campaigns (including inactive/unpublished)
* Test popups before going live

**Development Debugging:**

* Monitor events sent to PureClarity
* Debug tracking implementations
* Validate custom integrations

<Info>
  The debug toolbar is particularly valuable for custom implementations and development work.
</Info>

## Getting Started

### Enabling the Debug Toolbar

Add the debug parameter to your store URL:

```
https://www.your-store.com?pc_debug=true
```

**Steps:**

1. Navigate to your store in a browser
2. Add `?pc_debug=true` to the end of the URL
3. Press Enter to reload the page
4. Debug toolbar appears in top-left corner

<Tip>
  If your URL already has query parameters, use `&pc_debug=true` instead.
</Tip>

### Disabling the Debug Toolbar

**To close the toolbar:**

1. Click the **X** at the top of the menu
2. This stops debug mode completely
3. Page returns to normal operation

### Toolbar Interface

#### Default Display

* Appears as minimized icon in top-left corner
* Stays out of the way until needed
* Click to expand full interface

#### Positioning and Movement

**Toolbar is fully draggable:**

* Click and drag the blue border at the top
* Drag using the PureClarity logo
* Reposition anywhere on screen for convenience

**Panel management:**

* Close main panel to show menu only
* Minimize to return to icon state
* Expand/collapse as needed during testing

## Authentication

### Logging In

<Note>
  To access full toolbar functionality, log in using your PureClarity admin credentials.
</Note>

**Login process:**

1. Enter same credentials used for admin panel
2. Page refreshes after successful login
3. Full preview capabilities become available
4. Access to campaigns and popups

## Toolbar Panels

### Overview Panel

**Key information displayed:**

**Access Key**

* Your PureClarity store identifier
* Useful for verifying correct account connection

**Page Type**

* Page type sent to PureClarity in page\_view events
* Shows "No page type provided" if missing
* Critical for proper zone rendering

**PureClarity User ID**

* Unique identifier for current user
* Changes when users log in/out
* Useful for debugging user-specific issues

**PureClarity Session ID**

* Unique session identifier
* Different on each visit
* Helps track session-based behavior

<Warning>
  User and Session IDs are essential for debugging personalization and tracking issues.
</Warning>

### Zones Overview

**Zone status display:**

* Lists all zones present on current page
* Shows whether results were found for each zone
* Quick validation of zone implementation

**Zone management:**

* Identify missing or broken zones
* Verify zone placement and configuration
* Check zone-to-content mapping

### Zones - Campaigns

**Campaign preview capabilities:**

<Tip>
  Preview any campaign configured for a zone, including inactive and unpublished campaigns.
</Tip>

**Features:**

* **Active campaign display** - See currently running campaigns
* **Campaign switching** - Preview different campaigns for testing
* **Segment override** - Ignore segment conditions for testing
* **Real-time reload** - Refresh campaigns after admin changes
* **Zone location** - Find zone placement on page

**Testing workflow:**

1. Select zone to test
2. Choose campaign to preview
3. Verify display and functionality
4. Make adjustments in admin if needed
5. Reload to see changes

### Zones - Popups

**Popup testing features:**

**Preview options:**

* Test inactive or unpublished popups
* Override segment conditions for testing
* Verify popup design and functionality
* Check timing and trigger conditions

<Info>
  Perfect for testing popups targeting hard-to-replicate segments before making them live.
</Info>

### Events Overview

**Event monitoring and debugging:**

<Note>
  Displays all events that the clientscript has received on the current page.
</Note>

**Event types tracked:**

* **Tracking events** sent to PureClarity
* **Manual zone** retrieval calls
* **Currency change** events
* **Preview** function calls

**Data handling:**

* Full event data display
* Large data sets show copy button
* Click to copy complete event data
* Paste into text editor for detailed analysis

<Tip>
  Event monitoring is especially valuable for custom platform implementations and custom tracking setups.
</Tip>

## Best Practices

### Development Workflow

1. **Enable toolbar** during development and testing phases
2. **Test all zones** to ensure proper implementation
3. **Preview campaigns** before publishing
4. **Validate events** for custom implementations
5. **Disable toolbar** before production deployment

### Testing Strategy

**Systematic testing:**

* Test each zone individually
* Verify all campaign types
* Check popup functionality
* Monitor event tracking accuracy

**Segment testing:**

* Use segment override to test targeted content
* Verify segment conditions work correctly
* Test edge cases and boundary conditions

### Troubleshooting

**Common debugging tasks:**

* Verify correct access keys
* Check page type implementation
* Validate zone placement
* Debug event tracking issues
* Test cross-device functionality

## Related Tools

* [Development Usage](/support/general/development-usage)
* [Platform Settings](/support/general/settings)
* [Zone Configuration](/features/zones/overview)
* [Campaign Testing](/features/campaigns/preview-settings)