Django

Add Humblytics Analytics to a Django Site

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-Django)

Copy the snippet from Install Tracking Code:

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 your Django project

Option 1: Direct template integration (simple)

Best for: Quick setup, single environment

Open your base template file, typically:
- templates/base.html
- templates/layout.html
- Or your project's main template that other templates extend
Add the Humblytics script just before </head>:

django

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{% block title %}My Site{% endblock %}</title>
    
    {% block extra_head %}{% endblock %}
    
    <!-- Humblytics Analytics -->
    {% if not debug %}
    <script async src="https://app.humblytics.com/hmbl.min.js?id=YOUR_ID_HERE"></script>
    {% endif %}
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

Ensure child templates extend this base:

django

{% extends 'base.html' %}

{% block content %}
    <!-- Your page content -->
{% endblock %}

Note: {% if not debug %} prevents tracking in development when DEBUG = True.

Option 2: Using Django settings (recommended)

Best for: Production/staging environments, cleaner configuration

Add to your settings.py:

python

# settings.py

# Humblytics Analytics
HUMBLYTICS_ID = os.environ.get('HUMBLYTICS_ID', '')

# Only track in production
ENABLE_ANALYTICS = not DEBUG and HUMBLYTICS_ID

Add to .env file (for production):

env

HUMBLYTICS_ID=YOUR_ID_HERE

Create a context processor to make settings available in templates:

python

# your_app/context_processors.py

from django.conf import settings

def analytics(request):
    return {
        'HUMBLYTICS_ID': settings.HUMBLYTICS_ID,
        'ENABLE_ANALYTICS': settings.ENABLE_ANALYTICS,
    }

python

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates'],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
                'your_app.context_processors.analytics',  # Add this line
            ],
        },
    },
]

Update your base template:

django

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{% block title %}My Site{% endblock %}</title>
    
    {% block extra_head %}{% endblock %}
    
    <!-- Humblytics Analytics -->
    {% if ENABLE_ANALYTICS %}
    <script async src="https://app.humblytics.com/hmbl.min.js?id={{ HUMBLYTICS_ID }}"></script>
    {% endif %}
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

Option 3: Template include (for multiple base templates)

Best for: Projects with multiple base templates (e.g., public site, admin, blog)

Create templates/includes/analytics.html:

django

{% if not debug %}
<script async src="https://app.humblytics.com/hmbl.min.js?id=YOUR_ID_HERE"></script>
{% endif %}

Include it in each base template:

django

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{% block title %}My Site{% endblock %}</title>
    
    {% include 'includes/analytics.html' %}
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

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

4 · Deploy and verify

Clear Django caches (if using template caching):

bash

   python manage.py clear_cache  # If using django-redis or similar

Restart your Django server:

bash

   # Development
   python manage.py runserver
   
   # Production (example with Gunicorn)
   sudo systemctl restart gunicorn

If using static files CDN, ensure changes are deployed
Return to Humblytics and click Verify Website
Open your live site in a private/incognito window and refresh once
Within ~30 seconds you should see a green Verified badge and live visitor count

If verification fails, check:

Django-specific issues:

You're testing production environment, not development with DEBUG = True
Template changes are deployed (check file timestamps on server)
If using template caching, cache is cleared
Context processor is registered (for Option 2)
Environment variable is set correctly in production
Django server was restarted after changes

General issues:

Script ID matches your project in Humblytics
View page source (right-click → View Page Source) and search for "humblytics"
Check Django logs for template errors: python manage.py check
Open Developer Tools (F12) → Network tab and search for hmbl.min.js
No ad-blockers or browser extensions are blocking the script

Debug in Django shell:

python

python manage.py shell

>>> from django.conf import settings
>>> print(settings.DEBUG)  # Should be False in production
>>> print(getattr(settings, 'HUMBLYTICS_ID', 'Not set'))

5 · Explore & optimize

Dashboard – see traffic, top pages, and referrers
Heatmaps – auto-generated to reveal click hotspots and scroll depth
Experiments – run A/B tests without extra setup (Experiments → New Test)

PreviousBubble NextFramer

Last updated 1 month ago

Was this helpful?

Add Humblytics Analytics to a Django Site

1 · Sign up (or log in)

2 · Add your website in Humblytics

3 · Add the script to your Django project

Option 1: Direct template integration (simple)

Option 2: Using Django settings (recommended)

Option 3: Template include (for multiple base templates)

4 · Deploy and verify

5 · Explore & optimize