node package manager
We need your input. Help make JavaScript better: Take the 2017 JavaScript Ecosystem survey »


handlebars-helper-partial NPM version Build Status

Handlebars helper for rendering partials.

Install with npm

npm i handlebars-helper-partial --save


var helper = require('handlebars-helper-partial');

Handlebars example

var handlebars = require('handlebars');
// 1. pass your instance of handlebars 
var helper = require('handlebars-helper-partial')(handlebars);
// 2. register the helper, name it whatever you want 
handlebars.registerHelper('partial', helper);
// 3. register some partials 
handlebars.registerPartial('button', '<button>{{text}}</button>');
// 4. use in templates 
handlebars.compile('{{partial "button"}}')({text: 'Click me!'});
//=> '<button>Click me!</button>' 

Pass a specific context to the partial:

handlebars.compile('{{partial "button" a.b.c}}')({a: {b: c: {text: 'Click me!'}}});
//=> '<button>Click me!</button>' 

Related projects

  • handlebars-helpers: 120+ Handlebars helpers in ~20 categories, for Assemble, YUI, Ghost or any Handlebars project. Includes helpers like {{i18}}, {{markdown}}, {{relative}}, {{extend}}, {{moment}}, and so on.
  • template-helpers: Generic JavaScript helpers that can be used with any template engine. Handlebars, Lo-Dash, Underscore, or any engine that supports helper functions.

Running tests

Install dev dependencies.

npm i -d && npm test


Pull requests and stars are always welcome. For bugs and feature requests, please create an issue


Jon Schlinkert


Copyright (c) 2015 Jon Schlinkert
Released under the MIT license

This file was generated by verb-cli on March 13, 2015.