skip to navigation
skip to content

Not Logged In

django-less 0.7.1

Django template tags to compile LESS into CSS

Latest Version: 0.7.2

Django LESS provides template tags to compile LESS into CSS from templates. It works with both inline code and extenal files.


  1. Add "less" to INSTALLED_APPS setting.
  2. Make sure that you have lessc executable installed. See LESS official site for details.
  3. Optionally, you can specify the full path to lessc executable with LESS_EXECUTABLE setting. By default it’s set to lessc.
  4. In case you use Django’s staticfiles contrib app you have to add django-less’s file finder to the STATICFILES_FINDERS setting, for example :
    # other finders..

Example Usage


{% load less %}

  {% inlineless %}
    #header {
      h1 {
        font-size: 26px;
        font-weight: bold;
      p { font-size: 12px;
        a { text-decoration: none;
          &:hover { border-width: 1px }
  {% endless %}

renders to

  #header h1 {
    font-size: 26px;
    font-weight: bold;
  #header p {
    font-size: 12px;
  #header p a {
    text-decoration: none;
  #header p a:hover {
    border-width: 1px;

External file

{% load less %}

<link rel="stylesheet" href="{{ STATIC_URL}}{% less "path/to/styles.less" %}" />

renders to

<link rel="stylesheet" href="/media/LESS_CACHE/path/to/styles-91ce1f66f583.css" />

Note that by default compiled files are saved into LESS_CACHE folder under your STATIC_ROOT (or MEDIA_ROOT if you have no STATIC_ROOT in your settings). You can change this folder with LESS_ROOT and LESS_OUTPUT_DIR settings.

Note that all relative URLs in your stylesheet are converted to absolute URLs using your STATIC_URL setting.


Path to LESS compiler executable. Default: "lessc".
Controls the absolute file path that compiled files will be written to. Default: STATIC_ROOT.
Controls the directory inside LESS_ROOT that compiled files will be written to. Default: "LESS_CACHE".
Whether to use cache for inline styles. Default: True.
Cache timeout for inline styles (in seconds). Default: 30 days.
Cache timeout for reading the modification time of external stylesheets (in seconds). Default: 10 seconds.



  • Use hashlib instead of django.utils.hashcompat which is deprecated in Django 1.5
  • Add shell=True to Popen arguments when running on Windows.


  • Add staticfiles finder to serve compiled files in dev mode


  • Add LESS_ROOT setting


  • Fix unicodedecodeerror with non ascii in less file


  • Switch to staticfiles.finders when looking up the files in DEBUG mode.


  • Add support for lookup in STATICFILES_DIRS


  • Log LESS compilation errors
  • Fixed bug with paths on Windows


  • Use STATIC_ROOT / STATIC_URL settings when possible instead of MEDIA_ROOT / MEDIA_URL


  • Initial release
File Type Py Version Uploaded on Size
django-less-0.7.1.tar.gz (md5) Source 2013-04-14 10KB
  • Downloads (All Versions):
  • 56 downloads in the last day
  • 326 downloads in the last week
  • 1252 downloads in the last month