Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including liquid with all npm packages installed. Try it out:

var liquid = require("liquid")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

liquid v5.0.0

Node.js port of the Liquid template engine

Liquid with Node.js

This is a port of the original Liquid template engine from Ruby to Node.js. It uses Promises to support non-blocking/asynchronous variables, filters, and blocks.


  • Supports asynchronous variables, tags, functions and filters (helpers)
  • Supports whitespace control
  • Allows custom tags and filters to be added
  • Supports full liquid syntax
  • Based on original Ruby code
  • High test coverage

What does it look like?

<ul id="products">
  {% for product in products %}
      <h2>{{ }}</h2>
      Only {{ product.price | price }}

      {{ product.description | prettyprint | paragraph }}
  {% endfor %}


npm install liquid


Liquid supports a very simple API based around the Liquid.Engine class. For standard use you can just pass it the content of a file and call render with an object.

const Liquid = require('liquid')
const engine = new Liquid.Engine()

  .parse('hi {{name}}')
  .then(template => template.render({ name: 'tobi' }))
  .then(result => console.log(result))

// or

  .parseAndRender('hi {{name}}', { name: 'tobi' })
  .then(result => console.log(result))

Usage with Connect and Express

app.get((req, res, next) => {
    .parseAndRender('hi {{name}}', { name: 'tobi' })
    .nodeify((err, result) => {
      if (err) {
        res.end('ERROR: ' + err)
      } else {

Registering new filters

  myFilter: input => {
    return String(input).toUpperCase()

Registering new tags

Take a look at the existing tags to see how to implement them.

class MyTag extends Liquid.Tag {
  render () {
    return 'hello world'

engine.registerTag('MyTag', MyTag)


npm test

Similar libraries

  • harttle/liquidjs (liquidjs on npm) is another actively maintained Liquid parser and render for Node.js
  • darthapo's Liquid.js is liquid ported to JavaScript to be run within the browser. It doesn't handle asynchrony.
  • tchype's Liquid.js is liquid-node wrapped to run in a browser.



Contributors ✨

Thanks goes to these wonderful people (emoji key):

Marcel Jackwerth

💻 📖

Tony C. Heupel


Chen Yangjian


Henri Bergius


Sam Tiffin


Kris Ciccarello


Cory Reed

💻 💡 📖

Sebastian Seilund


Rob Loach


Sarah Schneider


Zeke Sikelianos

💻 📖 🚧

This project follows the all-contributors specification. Contributions of any kind welcome!

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free