> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalyr.com/llms.txt
> Use this file to discover all available pages before exploring further.
# HTML
> Add DATALYR tracking to any static HTML website
Add DATALYR to any HTML website or static site to track visitors, conversions, and revenue from ads.
## Use Cases
**Static Websites**
Track landing pages, portfolios, and static marketing sites built with plain HTML, CSS, and JavaScript.
**Custom Web Applications**
Add tracking to custom-built web apps without frameworks or build tools.
**Legacy Sites**
Track older websites that don't use modern frameworks or CMS platforms.
**HTML Email Landing Pages**
Track standalone landing pages linked from email campaigns.
## Before You Start
* [ ] You have a DATALYR account
* [ ] You've created a workspace
* [ ] You have access to edit your HTML files
* [ ] Your site is hosted somewhere accessible
## Step 1: Get Your Tracking Code
1. Log in to your DATALYR dashboard
2. Go to **Settings → Tracking**
3. Copy your tracking script:
```html theme={null}
```
## Step 2: Add to Your HTML
Open your HTML file and paste the tracking script in the `` section, before the closing `` tag:
```html theme={null}
Your Page Title
```
Replace `YOUR_WORKSPACE_ID` with your actual workspace ID from DATALYR.
## Step 3: Add to All Pages
If you have multiple HTML pages, add the same tracking script to each page's `` section:
* `index.html`
* `about.html`
* `contact.html`
* Any other pages
This ensures tracking works across your entire site.
## Step 4: Upload and Test
1. Upload your updated HTML files to your web host
2. Visit your website in a new browser tab
3. Go to your DATALYR dashboard
4. Click **Events** in the sidebar
5. You should see a `page_view` event within 10 seconds
If you see events, you're done!
## What Gets Tracked Automatically
Once installed, DATALYR automatically captures:
* Page views on all pages
* Visitor IDs (persistent across sessions)
* UTM parameters from ad campaigns
* Ad click IDs (fbclid, gclid, ttclid)
* Referrer and traffic source
* Device and browser information
## Track Form Submissions
Track form submissions as conversion events:
```html theme={null}
```
Add this tracking code right after your form or in a `
```
## Track Newsletter Signups
Track email capture for newsletter signups:
```html theme={null}
```
## Track External Link Clicks
Track when users click links to external sites:
```html theme={null}
```
Add this script to your `` or before the closing `` tag.
## Track Downloads
Track file downloads (PDFs, images, etc.):
```html theme={null}
Download eBook
```
## Track Video Plays
Track when users play embedded videos:
```html theme={null}
```
## Identify Users
If you collect user information, identify users for cross-device tracking:
```html theme={null}
```
Add this after successful authentication or signup.
## Using Template Files
If you use server-side includes or templates, add the tracking script to your header template once:
**header.html**
```html theme={null}
My Site
```
Then include this header in all your pages. The tracking script will be automatically added to every page.
## Troubleshooting
**Not seeing events?**
Check that:
* Your tracking script is in the `` section of your HTML
* You've uploaded the updated files to your web host
* Your workspace ID is correct
* Ad blockers are disabled
* Your site is accessible via HTTPS (recommended)
**Script not loading?**
Open browser dev tools (F12) and check the Network tab. Look for `dl.js` to see if it loaded successfully.
**Events firing multiple times?**
Make sure you only have one instance of the DATALYR script on each page. Search for `track.datalyr.com` in your HTML.
**TypeError: datalyr is undefined?**
The script hasn't loaded yet. Wrap your tracking code in a check:
```javascript theme={null}
if (window.datalyr) {
datalyr.track('event_name', { ... });
} else {
console.log('DATALYR not loaded yet');
}
```
## Next Steps
Confirm events are coming through
Learn event tracking API
Link Meta Ads, Google Ads, TikTok
See your tracking data
## Need Help?
Having trouble with HTML tracking? Check our [troubleshooting guide](/troubleshooting/tracking-not-working) or contact support.