Skip to main content

Icons for Django

Project description

Icons for Django Latest PyPI version


Use simple template tags to generate icons in your web application. Supports Font Awesome out of the box, easily adaptable for other icon libraries.

The basic usage in a Django template:

{% load icons %}
{% icon 'edit' %}


This package requires a Python 3.6 or newer and Django 2.2 or newer.

The combination must be supported by the Django Project. See “Supported Versions” on

Running the demo

You can run the small demo app that is part of the test suite. This requires Django, so you may have to pip install django in your environment. To run the demo, from the root of the project (where you can find, run:

python runserver

Running the tests

The test suite uses tox. Run the complete test suite like this:


Run the tests only for the current environment like this:

python test


Our plans at Zostera for an icon tool originate in We isolated this into a Font Awesome tool in When using our own product, we felt that the icon tool provided little improvement over plain HTML. Also, Font Awesome’s icon names did not match the the intended function of the icon. This is how we came to think of a library that

  • Took a limited number of arguments
  • Converted those arguments into an icon
  • Was able to support multiple icon libraries
  • And could easily be extended by users

This is how we came to write and use django-icons.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-icons, version 2.0.0
Filename, size File type Python version Upload date Hashes
Filename, size django_icons-2.0.0-py3-none-any.whl (13.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size django-icons-2.0.0.tar.gz (11.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page