---
id: django-sass-processor
version: "1.4.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# django-sass-processor — SASS processor to compile SCSS files into *.css, while rendering, or offline.

License: permissive · Maintenance: active · Downloads: 252.0K/mo

## What it is and what it does

django-sass-processor is a Django app that compiles SASS/SCSS files into CSS during template rendering, without requiring external build tools, file watchers, or IDE plugins. It provides a templatetag `sass_src` that works in both Django and Jinja2 templates, and can also be used directly in Python code via the Media class for forms and admin. The processor caches compiled output and only recompiles when source files are modified, making it suitable for development workflows.

The package supports configuration through Django settings for include paths, compiler precision, and output style. It can also generate sourcemaps for easier debugging. For production, SCSS files can be precompiled offline using a management command, eliminating the need for a compiler in the deployed environment. The app automatically discovers SCSS partials in installed Django apps' static folders, reducing boilerplate configuration.

Use it for:

- Develop Django projects with SCSS without running a separate daemon or build tool.
- Reference SCSS files directly in templates and have them compile to CSS on demand during development.
- Configure SASS variables and paths in Django settings.py instead of maintaining separate SCSS configuration files.
- Debug stylesheet errors directly in Django's development server console with sourcemaps.
- Precompile SCSS offline and deploy only CSS to production, avoiding compiler as a runtime dependency.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Compiles SASS/SCSS files to CSS on the fly during Django template rendering, eliminating the need for external build tools or file watchers.

Yes. The package is actively maintained, has no runtime dependencies, supports current Django versions (3.2 through 5.2) and Python versions (3.8 through 3.13), carries no known vulnerabilities, and solves a real friction point in Django development. Install it if you use SCSS in templates and want to avoid external build-tool overhead; skip it only if your project already has a mature build pipeline in place.

## Install

pip install django-sass-processor
uv add django-sass-processor
poetry add django-sass-processor

## Installing django-sass-processor

Before you install: Low friction install with no runtime dependencies. Active maintenance since 2015, last commit 2026-03-09, and supports Django 3.2, 4.2, 5.0, 5.1, 5.2 and Python 3.8, 3.9, 3.10, 3.11, 3.12, 3.13.

License in practice: MIT license permits permissive use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install django-sass-processor

# In settings.py
INSTALLED_APPS = ['sass_processor', ...]
STATICFILES_FINDERS = [
    'django.contrib.staticfiles.finders.FileSystemFinder',
    'django.contrib.staticfiles.finders.AppDirectoriesFinder',
    'sass_processor.finders.CssFinder',
]

# In template
{% load sass_tags %}
<link rel="stylesheet" href="{% sass_src 'path/to/file.scss' %}">


A SASS compiler is required during development; offline compilation via manage.py compilescss is available for production deployment.

Verify before relying:

- Whether a system SASS compiler must be installed separately or is bundled with the package.
- Performance characteristics when compiling large or deeply nested SCSS file hierarchies with many imports.
- Whether django-compressor is required for offline compilation or only optional.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 252.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django sass scss compiler, sass processor django, compile scss to css django, sass templatetag django, django static file sass, scss compilation django, sass preprocessing django, django-integration, css-preprocessing, development-tools

[View on SkillFed](https://skillfed.io/packages/django-sass-processor) · [View on PyPI](https://pypi.org/project/django-sass-processor/)