# Django
## Add Humblytics Analytics to a Django Site
### 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-Django`)
Copy the snippet from **Install Tracking Code**:
html
```html
```
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
1. Open your base template file, typically:
* `templates/base.html`
* `templates/layout.html`
* Or your project's main template that other templates extend
2. Add the Humblytics script just before ``:
django
```django
{% block title %}My Site{% endblock %}
{% block extra_head %}{% endblock %}
{% if not debug %}
{% endif %}
{% block content %}{% endblock %}
```
3. Ensure child templates extend this base:
django
```django
{% extends 'base.html' %}
{% block 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
1. Add to your `settings.py`:
python
```python
# settings.py
# Humblytics Analytics
HUMBLYTICS_ID = os.environ.get('HUMBLYTICS_ID', '')
# Only track in production
ENABLE_ANALYTICS = not DEBUG and HUMBLYTICS_ID
```
2. Add to `.env` file (for production):
env
```env
HUMBLYTICS_ID=YOUR_ID_HERE
```
3. Create a context processor to make settings available in templates:
python
```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,
}
```
4. Register the context processor in `settings.py`:
python
```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
],
},
},
]
```
5. Update your base template:
django
```django
{% block title %}My Site{% endblock %}
{% block extra_head %}{% endblock %}
{% if ENABLE_ANALYTICS %}
{% endif %}
{% block content %}{% endblock %}
```
#### Option 3: Template include (for multiple base templates)
**Best for:** Projects with multiple base templates (e.g., public site, admin, blog)
1. Create `templates/includes/analytics.html`:
django
```django
{% if not debug %}
{% endif %}
```
2. Include it in each base template:
django
```django
{% block title %}My Site{% endblock %}
{% include 'includes/analytics.html' %}
{% block content %}{% endblock %}
```
**Note**: Replace `YOUR_ID_HERE` with your actual project ID from Humblytics.
### 4 · Deploy and verify
1. **Clear Django caches** (if using template caching):
bash
```bash
python manage.py clear_cache # If using django-redis or similar
```
2. **Restart your Django server**:
bash
```bash
# Development
python manage.py runserver
# Production (example with Gunicorn)
sudo systemctl restart gunicorn
```
3. **If using static files CDN**, ensure changes are deployed
4. Return to Humblytics and click **Verify Website**
5. Open your live site in a private/incognito window and refresh once
6. 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
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)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.humblytics.com/how-to-get-started/django.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.