---
id: pallets-sphinx-themes
version: "2.5.0"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# Pallets-Sphinx-Themes — Sphinx themes for Pallets and related projects.

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

## What it is and what it does

Pallets Sphinx Themes provides a set of pre-built Sphinx themes designed for the Pallets project ecosystem (Flask, Jinja, Werkzeug, Click). It solves the problem of maintaining visual consistency across documentation for related Python projects by offering themed templates that can be enabled in a Sphinx configuration file. The package is a pure Python wheel with low installation friction, depending only on packaging, sphinx, and sphinx-notfound-page.

You use it by adding the extension to your Sphinx conf.py and selecting one of the four available themes by name. It's intended for projects that want to adopt the Pallets documentation aesthetic or for extension authors working within the Pallets ecosystem who need their documentation to match the parent project's look and feel.

Use it for:

- Building documentation for Flask extensions that should visually match the main Flask docs.
- Styling Jinja template documentation to align with the official Jinja project theme.
- Creating consistent documentation for Werkzeug-based projects or middleware.
- Documenting Click command-line applications with the Click project's visual identity.

## Worth the install?

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

Provides Sphinx themes styled for Pallets project documentation (Flask, Jinja, Werkzeug, Click), enabling consistent visual presentation across related projects.

Yes, if you are documenting a Pallets project or extension and want immediate visual consistency without designing a theme from scratch. The package is actively maintained, has no known vulnerabilities, and carries a permissive license. Install only if you intend to use one of the four named themes; it adds no value for unrelated Sphinx projects.

## Install

pip install pallets-sphinx-themes
uv add pallets-sphinx-themes
poetry add pallets-sphinx-themes

## Installing Pallets-Sphinx-Themes

Before you install: Low install friction with three straightforward runtime dependencies (packaging, sphinx, sphinx-notfound-page). Repository is actively maintained with recent commits and no archived status.

License in practice: BSD-3-Clause permissive license allows use in most projects with minimal restrictions; attribution required but no copyleft obligations.

Quickstart:

pip install pallets-sphinx-themes

In docs/conf.py:
extensions = ["pallets_sphinx_themes"]
html_theme = "flask"  # or jinja, werkzeug, click

Requires Python 3.10 or later.

Verify before relying:

- Whether all four themes (flask, jinja, werkzeug, click) are equally mature and feature-complete.
- Customization depth available beyond theme selection in conf.py.
- Whether this package is suitable for non-Pallets projects seeking similar styling.

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 131.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sphinx theme pallets, flask documentation theme, sphinx theme flask jinja werkzeug, pallets project documentation, sphinx documentation styling, consistent sphinx themes, werkzeug click documentation theme, sphinx-theme, pallets-ecosystem

[View on SkillFed](https://skillfed.io/packages/pallets-sphinx-themes) · [View on PyPI](https://pypi.org/project/pallets-sphinx-themes/)