Django Tag Me 
Simple, flexible tagging for Django.
Add tags to any Django model field -- with a polished widget, per-user tag customization, and automatic resilience to model renames.
Features
- Easy setup -- Add
TagMeCharFieldto your model and go - Beautiful widget -- Searchable dropdown with tag pills, powered by Alpine.js
- User tags -- Each user gets their own customizable tag set per field
- System tags -- Define default tags available to all users
- Tag synchronization -- Keep tags in sync across related models
- Model rename resilient -- FK-based lookups with automatic orphan detection and repair
- CLI diagnostics -- Health checks, orphan repair, and built-in troubleshooting via
tag_mecommand - Structured logging -- Observability via structlog for production monitoring
- Form integration -- Drop-in mixin for your model forms
- Template tags -- Display tags as styled pills
Quick Example
# models.py
from tag_me.models import TagMeCharField
class Article(models.Model):
tags = TagMeCharField(blank=True)
category = TagMeCharField(choices=CategoryChoices.choices, system_tag=True)
# forms.py
from tag_me.forms import TagMeModelFormMixin
class ArticleForm(TagMeModelFormMixin, forms.ModelForm):
class Meta:
model = Article
fields = ["tags", "category"]
See the Quickstart for the full setup including templates and frontend requirements.
Widget Preview
Dropdown with tag options
Search and filter tags
Model Rename Resilience
Rename your Django models without breaking tags. Tag-me uses ContentType foreign keys instead of model name strings, and automatically detects and merges orphaned records during migration.
# Rename your model, then:
python manage.py makemigrations # answer "yes" to rename prompt
python manage.py migrate # tag-me handles the rest
# Verify everything is clean:
python manage.py tag_me check
See How to Upgrade to FK Lookup for details on the FK-based system.
Management Command
Tag-me includes a CLI for diagnostics and administration:
python manage.py tag_me populate # create/update tags
python manage.py tag_me check # data integrity audit
python manage.py tag_me fix-orphans --dry-run # preview orphan repair
python manage.py tag_me help # built-in documentation
Tag population runs automatically after every migrate. The CLI exists for diagnostics, manual repair, and single-user operations.
See How to Use the Tag-me CLI for the full guide.
Installation
pip install django-tag-me
See the documentation for setup and usage instructions.
Links
Credits
- Dropdown interface adapted from alpinejs-multiselect
- Built with Django Cookiecutter
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_tag_me-2026.8.2.1.tar.gz.
File metadata
- Download URL: django_tag_me-2026.8.2.1.tar.gz
- Upload date:
- Size: 213.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3a3d7dd3360436601a6911dd56772a3d747354206401a067298561be55b1dd23
|
|
| MD5 |
f20337a09e481544a29d315b65dd7319
|
|
| BLAKE2b-256 |
8bef6464d0f6185355c0c82165fcad7d3f0aa80fa902063d4700a2ab062405e6
|
File details
Details for the file django_tag_me-2026.8.2.1-py3-none-any.whl.
File metadata
- Download URL: django_tag_me-2026.8.2.1-py3-none-any.whl
- Upload date:
- Size: 112.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
43a4872e114e2e3376b4586c115c28e7be0f90f16a066c076453d19756719f05
|
|
| MD5 |
3bef71647f96dd4df6ace7a51129e355
|
|
| BLAKE2b-256 |
624610a386c6549662832a54a707454da3c11568bdfec2c28935cdcfe2a68385
|
