---
id: liquidpy
version: "0.10.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# liquidpy — A port of liquid template engine for python

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

## What it is and what it does

Liquidpy adapts the Liquid template language—originally from Ruby and widely used in Jekyll and Shopify—to Python by building on jinja2's foundation. It lets you write and render templates using Liquid syntax rather than jinja2's native syntax, which is useful if you're migrating templates from Ruby environments, working with Jekyll sites, or need Shopify template compatibility.

The package supports multiple template modes: standard Liquid, Jekyll-flavored Liquid, Shopify-extended Liquid, and a "wild" mode that adds Python code execution capabilities. You can load templates from strings or files, customize rendering through jinja2's environment API, and adjust defaults globally. It's a compatibility layer built on jinja2, so it inherits jinja2's performance and stability.

Use it for:

- Migrating Jekyll blog templates or static site generators from Ruby to a Python workflow.
- Rendering Shopify theme templates in a Python backend without switching template languages.
- Building a templating system that accepts Liquid syntax from users familiar with Jekyll or Shopify.
- Converting existing Liquid template codebases to Python while preserving template syntax unchanged.

## Worth the install?

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

Liquidpy is a Python port of the Liquid template engine built on Jinja2, letting you render templates in Liquid syntax with support for standard, Jekyll, Shopify, and extended "wild" modes.

Yes, if you need to render Liquid templates in Python. The package is actively maintained, has no known vulnerabilities, installs cleanly with minimal dependencies, and solves a real compatibility problem for teams migrating from Ruby or Shopify environments. Not necessary if you're already comfortable with jinja2's native syntax.

## Install

pip install liquidpy
uv add liquidpy
poetry add liquidpy

## Installing liquidpy

Before you install: Install friction is low—a pure-Python wheel with only jinja2 as a runtime dependency. The project is actively maintained with a recent release 4 days old.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install liquidpy

from liquidpy import Liquid
liq = Liquid('{{a}}', from_file=False)
result = liq.render(a=1)

Requires Python >=3.9.

Verify before relying:

- Performance characteristics when rendering large or complex templates compared to native jinja2.
- Test coverage and code quality metrics referenced in the project's badges.
- Whether the "wild" mode's Python code execution has security implications for untrusted templates.

## Package facts

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

## Tags

liquid template engine python, jinja2 liquid templates, jekyll template rendering, shopify liquid syntax, template engine multiple modes, template-engine, liquid-syntax

[View on SkillFed](https://skillfed.io/packages/liquidpy) · [View on PyPI](https://pypi.org/project/liquidpy/)