Skip to content
Simple tagging for django http://django-taggit.readthedocs.org/
Python
Latest commit 51e37f0 @frewsxcv frewsxcv Merge pull request #374 from alex/release
Prepare for 0.18.0 release

README.rst

django-taggit

django-taggit a simpler approach to tagging with Django. Add "taggit" to your INSTALLED_APPS then just add a TaggableManager to your model and go:

from django.db import models

from taggit.managers import TaggableManager

class Food(models.Model):
    # ... fields here

    tags = TaggableManager()

Then you can use the API like so:

>>> apple = Food.objects.create(name="apple")
>>> apple.tags.add("red", "green", "delicious")
>>> apple.tags.all()
[<Tag: red>, <Tag: green>, <Tag: delicious>]
>>> apple.tags.remove("green")
>>> apple.tags.all()
[<Tag: red>, <Tag: delicious>]
>>> Food.objects.filter(tags__name__in=["red"])
[<Food: apple>, <Food: cherry>]

Tags will show up for you automatically in forms and the admin.

django-taggit requires Django 1.4.5 or greater.

For more info check out the documentation. And for questions about usage or development you can contact the mailinglist.

Something went wrong with that request. Please try again.