Welcome to django-taggit’s documentation!

django-taggit is a reusable Django application designed to make adding tagging to your project easy and fun.

django-taggit works with Django 5.2+ and Python 3.10+.

• Getting Started
  • Settings
• Tags in forms
  • commit=False
• Using tags in the admin
  • Including tags in ModelAdmin.list_display
  • Merging tags in the admin
• Usage With Django Rest Framework
• Testing
  • Natural Key Support
• The API
  • TaggableManager
  • Filtering
• Frequently Asked Questions
• Customizing taggit
  • Using a Custom Tag or Through Model
  • Using a custom tag string parser
• Contributing to django-taggit
  • Reach out before you start
  • Fork the repository
  • Running tests
  • Running the sample application
  • Follow style conventions (black, flake8, isort)
  • Update the documentation
  • Add a changelog line
  • Send pull request
  • Release Checklist
• External Applications
• Changelog
  • (Unreleased)
  • 6.1.0 (2024-09-29)
  • 6.0.0 (2024-07-27)
  • 5.0.1 (2023-10-26)
  • 5.0.0 (2023-10-24)
  • 4.0.0 (2023-05-04)
  • 3.1.0 (2022-11-08)
  • 3.0.0 (2022-05-02)
  • 2.1.0 (2022-01-24)
  • 2.0.0 (2021-11-14)
  • 1.5.1 (2021-07-01)
  • 1.5.0 (2021-06-30)
  • 1.4.0 (2021-04-19)
  • 1.3.0 (2020-05-19)
  • 1.2.0 (2019-12-03)
  • 1.1.0 (2019-03-22)
  • 1.0.0 (2019-03-17)
  • 0.24.0 (2019-02-19)
  • 0.23.0 (2018-08-07)
  • 0.22.2 (2017-12-27)
  • 0.22.1 (2017-04-22)
  • 0.22.0 (2017-01-29)
  • 0.21.6 (2017-01-25)
  • 0.21.5 (2017-01-21)
  • 0.21.4 (2017-01-10)
  • 0.21.3 (2016-10-07)
  • 0.21.2 (2016-08-31)
  • 0.21.1 (2016-08-25)
  • 0.21.0 (2016-08-22)
  • 0.20.2 (2016-07-11)
  • 0.20.1 (2016-06-23)
  • 0.20.0 (2016-06-19)
  • 0.19.1 (2016-05-25)
  • 0.19.0 (2016-05-23)
  • 0.18.3 (2016-05-12)
  • 0.18.2 (2016-05-08)
  • 0.18.1 (2016-03-30)
  • 0.18.0 (2016-01-18)
  • 0.17.6 (2015-12-09)
  • 0.17.5 (2015-11-27)
  • 0.17.4 (2015-11-25)
  • 0.17.3 (2015-10-26)
  • 0.17.2 (2015-10-25)
  • 0.17.1 (2015-09-10)
  • 0.17.0 (2015-08-14)
  • 0.16.4 (2015-08-13)
  • 0.16.3 (2015-08-08)
  • 0.16.2 (2015-07-13)
  • 0.16.1 (2015-07-09)
  • 0.16.0 (2015-07-04)
  • 0.15.0 (2015-06-23)
  • 0.14.0 (2015-04-26)
  • 0.13.0 (2015-04-02)
  • 0.12.3 (2015-03-03)
  • 0.12.2 (2014-21-09)
  • 0.12.1 (2014-10-08)
  • 0.12.0 (2014-20-04)
  • 0.11.2 (2013-13-12)
  • 0.11.1 (2013-25-11)
  • 0.11.0 (2013-25-11)
  • 0.10.0 (2013-17-08)
  • 0.9.2 (2011-01-17)
  • 0.9.0 (2010-09-22)
  • 0.8.0 (2010-06-22)

Indices and tables

• Index

• Module Index

• Search Page