# WordPress

## Add Humblytics Analytics to WordPress

### 1 · Sign up (or log in)

Visit humblytics.com → Start Free Trial. Finish signup—or log in to your existing workspace.

### 2 · Add your website in Humblytics

In the sidebar, click **Add Website**.

* **Domain** – enter `your-domain.com` (omit `https://` and `www`)
* **Site Name** – internal label (e.g. `Marketing-Prod`)

Copy the snippet from **Install Tracking Code**:

html

```html
<!-- Start Humblytics Tracking Code -->
<script async src="https://app.humblytics.com/hmbl.min.js?id=YOUR_ID_HERE"></script>
<!-- End Humblytics Tracking Code -->
```

Keep this tab open—we'll return and click **Verify Website** once the tag is live.

### 3 · Add the script to WordPress

#### Option 1: Using a plugin (recommended)

**Best for:** Most WordPress sites—survives theme changes and updates

**Method A: WPCode (formerly Insert Headers and Footers)**

1. In your WordPress dashboard, go to **Plugins → Add New**
2. Search for **WPCode - Insert Headers and Footers**
3. Click **Install Now**, then **Activate**
4. Go to **Code Snippets → Header & Footer**
5. Paste your Humblytics script into the **Header** section
6. Click **Save Changes**

**Method B: Code Snippets (alternative)**

1. In your WordPress dashboard, go to **Plugins → Add New**
2. Search for **Code Snippets**
3. Click **Install Now**, then **Activate**
4. Go to **Snippets → Add New**
5. Give it a name (e.g., "Humblytics Analytics")
6. Paste this code:

php

```php
add_action('wp_head', function() {
    echo '<script async src="https://app.humblytics.com/hmbl.min.js?id=YOUR_ID_HERE"></script>';
});
```

7. Set to run **Only run on site front-end**
8. Click **Save Changes and Activate**

**Note**: Replace `YOUR_ID_HERE` with your actual project ID from Humblytics.

#### Option 2: Add to your theme

**Only use this if:** You manage a custom theme or child theme

⚠️ **Warning**: Direct theme edits will be lost when you update your theme. Always use a child theme or the plugin method instead.

**Using a child theme (safe method):**

1. Create or activate a child theme
2. In your child theme's `functions.php`, add:

php

```php
add_action('wp_head', function() {
    echo '<script async src="https://app.humblytics.com/hmbl.min.js?id=YOUR_ID_HERE"></script>';
});
```

3. Save the file

**Direct theme edit (not recommended):**

1. Go to **Appearance → Theme File Editor**
2. **Accept the warning** about editing theme files
3. Select **header.php** from the right sidebar
4. Locate the closing `</head>` tag
5. Paste your Humblytics script just before `</head>`
6. Click **Update File**

⚠️ **Important**: You'll need to re-add this script every time you update your theme.

### 4 · Verify installation

1. **Clear your cache** (if using WP Rocket, W3 Total Cache, etc.)
2. Return to Humblytics and click **Verify Website**
3. Open your live site in a private/incognito window and refresh once
4. Within \~30 seconds you should see a green **Verified** badge and live visitor count

**If verification fails, check:**

* Script ID matches your project in Humblytics
* You cleared WordPress cache and any CDN cache (Cloudflare, etc.)
* The script appears in your page source (right-click → View Page Source, search for "humblytics")
* No security plugins are blocking external scripts (check Wordfence, Sucuri settings)
* No ad-blockers or browser extensions are interfering

**Common WordPress caching plugins:**

* WP Rocket: Clear cache in **Settings → WP Rocket → Clear Cache**
* W3 Total Cache: Go to **Performance → Dashboard → Empty All Caches**
* WP Super Cache: Go to **Settings → WP Super Cache → Delete Cache**

### 5 · Explore & optimize

* **Dashboard** – track traffic, top pages, and referrers
* **Heatmaps** – auto-generated click & scroll analysis
* **Experiments** – run A/B tests without extra code (Experiments → New Test)