Skip to main content

Font Awesome for Django

Project description

Font Awesome for Django.


  1. Install using pip:

    pip install django-fa

    Alternatively, you can install download or clone this repo and call pip install -e ..

  2. Add to INSTALLED_APPS in your


  3. Use the font-awesome tag library in your templates

Example template

{% load font_awesome %}

{# Load CSS #}

{% fa_css %}

{# Display an icon #}

{% fa 'fa-shield' %}


See for complete documentation.

Compatible Django and Python versions

Currently django-fa requires Django >= 1.8 and a matching Python version.

Python and Django support will match the Django project. When a Django or Python versions is no longer supported by the Django Project, this package will also stop supporting those versions. You are strongly encouraged to upgrade to the newest (LTS) combination of Python/Django.


Django >= 1.8 and a matching Python version

Bugs and requests

If you have found a bug or if you have a request for additional functionality, please use the issue tracker on GitHub.


You can use this under the MIT License. See LICENSE file for details.


Developed and maintained by Zostera.

Original author & Development lead: Dylan Verheul.

Thanks to everybody that has contributed pull requests, ideas, issues, comments and kind words.

Please see AUTHORS.rst for a list of contributors.

1.0.0 - in development

  • Rename fa to icon
  • No longer automatically prepend fa to icon parameters
  • Drop support for Django 1.9

0.4.0 - 2017-05-26

  • Default to to Font Awesome 4.7.0
  • Fix Travis CI and unit tests
  • Fix ReadThe Docs Documentation

0.3.0 - 2016-02-26

  • Default to Font Awesome 4.4.5
  • Removed warnings for Django 1.10

0.2.0 - 2015-08-11

  • Font Awesome 4.4.0 is default now
  • 100% coverage in tests

0.1.1 - 2015-07-26

  • First publication on GitHub

Project details

Download files

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

Source Distribution

django-fa-1.0.0.tar.gz (1.5 MB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page