> ## Documentation Index
> Fetch the complete documentation index at: https://docs.permutive.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Quick Start
> Get up and running with the Permutive JavaScript SDK in minutes
This guide walks you through adding the SDK to your page and tracking your first pageview.
## Prerequisites
* Your Permutive **Workspace API Key**, **Workspace ID**, and **Organization ID** (from your [dashboard](https://dash.permutive.com/settings/project/))
* Access to edit your website's HTML or tag manager
## Step 1: Add the SDK
Add the following code to the `` section of your page, as early as possible. This ensures the SDK loads before other scripts and can queue events immediately.
```html theme={"dark"}
```
Replace ``, ``, and `` with your credentials from the Permutive dashboard.
**Queue-Based Loading:** The SDK uses a queue-based pattern. You can call SDK methods immediately - they're queued and executed once the SDK loads.
## Step 2: Initialize the Web Addon
The web addon provides automatic pageview tracking, engagement measurement, and more. Add this code after the SDK script:
```html theme={"dark"}
```
Customize the `page` object with your content metadata. This enables contextual targeting and richer insights.
## Step 3: Complete Example
Here's a complete example with the SDK, web addon, and page properties:
```html theme={"dark"}
My Article
```
## Step 4: Verify the Integration
1. **Enable Debug Mode**: Add `?__permutive.loggingEnabled=true` to your page URL
2. **Open Developer Console**: Press F12 or right-click and select "Inspect", then go to the Console tab
3. **Look for SDK Messages**: You should see messages like:
```
[Permutive] SDK initialized
[Permutive] Pageview tracked
```
4. **Check localStorage**: In Developer Tools, go to Application > Local Storage and look for keys starting with `permutive-` or `_p`
If you see "Permutive SDK initialized" and "Pageview tracked" messages, your integration is working correctly.
## What Happens Automatically
With the web addon configured, the SDK automatically:
* **Tracks Pageview events** when the page loads
* **Measures engagement time** (PageviewEngagement events)
* **Tracks page completion** (PageviewComplete when user leaves)
* **Captures form submissions** (FormSubmission events)
* **Records link clicks** (LinkClick events for outbound links)
## Next Steps
Tag manager options
Advanced SDK configuration
Customize pageview tracking
Track users across sessions