> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knock2.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Install the Knock2 Tracking Script on Your Website
> Embed the Knock2 sidekick.js tracking script on your website to automatically identify visiting companies and contacts in real time.
The Knock2 tracking script is the foundation of your visitor identification pipeline. Once embedded in your site's ``, it silently captures session data for every visitor and sends it to Knock2's identification engine — no personally identifiable information is collected on the client side, and the script never blocks your page from loading.
## Get the Embed Snippet
Fetch your personalized embed snippet from the API. The response includes a `script_url` and a ready-to-paste `embed_html` tag pre-configured with your tenant slug.
```bash theme={null}
curl https://api.knock2.ai/v1/script \
-H "Authorization: Bearer YOUR_API_KEY"
```
```json theme={null}
{
"data": {
"product_slug": "your_tenant",
"script_url": "https://api.knock2.ai/install/your_tenant/prod",
"embed_html": ""
}
}
```
Copy the `embed_html` value exactly as returned. The script is served directly from Knock2's API (not a separate CDN domain) — the tenant slug is resolved server-side from your API key and baked into the URL path, so there's no `data-slug` attribute to configure.
## Add the Script to Your Site
Copy the full value of `embed_html` from the API response above. It looks like:
```html theme={null}
```
Place the snippet before the closing `` tag on every page you want to track. A typical HTML document looks like this:
```html theme={null}
Your Site
```
Publish the change through your normal deployment process. The script will begin collecting visitor data as soon as the updated page is live and receives its first non-localhost visit.
## Verify Installation
Once your site is live, confirm that Knock2 is receiving data by calling the script status endpoint.
```bash theme={null}
curl https://api.knock2.ai/v1/script/status \
-H "Authorization: Bearer YOUR_API_KEY"
```
```json theme={null}
{
"data": {
"is_installed": true,
"visitor_count_last_7_days": 42,
"last_visit_at": "2024-06-01T14:23:00Z"
}
}
```
| Field | Description |
| --------------------------- | ------------------------------------------------------------------------------------------ |
| `is_installed` | `true` when at least one unique non-localhost visitor has been recorded in the last 7 days |
| `visitor_count_last_7_days` | Total unique visitor IPs recorded in the current 7-day window |
| `last_visit_at` | ISO 8601 timestamp of the most recent visitor session |
If `is_installed` is `false` after deploying, double-check that the snippet is present in the rendered HTML of your live site (use your browser's View Source or DevTools Network tab to confirm the request to your `/install/{your_tenant}/prod` script URL loads).
## Framework-Specific Tips
**Pages Router (`_document.js`)**
Add the script tag inside the `` component in `pages/_document.js`:
```jsx theme={null}
import { Html, Head, Main, NextScript } from 'next/document';
export default function Document() {
return (
);
}
```
**App Router (`app/layout.tsx`)**
Use the Next.js `