Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Icons for Django

Project Description


Icons for Django


While version < 1 (0.x.y), this project will not be fit for production use, and not adhere to semver. From 1.0.0 on, django-icons will be deemed product ready and semantic versioning will be respected.


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 is

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


Django >= 1.11 and a matching Python version. Using Python 3 is strongly recommended.

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.


0.1.0 - in progress

0.0.5 - 2017-12-21

  • Fix typo’s
  • Adjust tox matrix to currently supported Django versions
  • Fixed names of tests
  • Add tests for BaseRenderer

0.0.4 - 2017-06-22

  • Autogenerate docs for icon template tag
  • Fix typo in README

0.0.3 - 2017-06-22

  • Bug fixes
  • More tests
  • More documentation

0.0.2 - 2017-06-19

  • Updated docs and tests
  • Demo of custom SVG renderer included
  • FontAwesome and Bootstrap3 renderers included
  • New structure for settings dict
  • First documentation, linked to ReadTheDocs
  • First tests
  • Introducing the icon template tag

0.0.1 - 2017-06-15

  • First publication on GitHub and PyPI
  • Non-functional, just names and tests

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(1.6 MB) Copy SHA256 Hash SHA256
Source Jan 11, 2018

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting