skip to navigation
skip to content

django-scss 0.4.1

Django template tags to compile SCSS into CSS

Latest Version: 0.6.1

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


  1. Add “django_scss” to INSTALLED_APPS setting.
  2. Make sure that you have sass executable installed. See SASS official site for details.
  3. Optionally, you can specify the full path to sass executable with SCSS_EXECUTABLE setting. By default it’s set to sass.

Example Usage


{% load scss %}

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

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 scss %}

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

renders to

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

Note that by default compiled files are saved into SCSS_CACHE folder under your STATIC_ROOT (or MEDIA_ROOT if you have no STATIC_ROOT in your settings). You can change this folder name with SCSS_OUTPUT_DIR setting.

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


Path to SASS compiler executable. Default: “sass”.
Output directory for compiled external stylesheets. It’s relative to STATIC_ROOT. Default: "SCSS_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.
Boolean. Wheter to use compass or not. Compass must be installed in your system. Run “sass –compass” and if no error is shown it means that compass is installed.



  • Fix unicodedecodeerror with non ascii in scss file


  • Switch to staticfiles.finders when looking up the files in DEBUG mode.
  • Fix the CWD when running scss compiler


  • Add support for lookup in STATICFILES_DIRS
  • Allow to use Compass


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


  • Initial release
File Type Py Version Uploaded on Size
django-scss-0.4.1.tar.gz (md5) Source 2012-12-25 7KB