Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Handlebars helper, alternative to built-in partials. Like Assemble itself, this helper will automatically determine the correct context to use, or a context may be explicitly passed in as a second parameter.
branch: master
Failed to load latest commit information.
.editorconfig lint
.gitattributes lint
.gitignore lint
.jshintrc lint
.travis.yml lint generate readme
LICENSE lint generate readme
index.js refactor
package.json 0.2.0
test.js refactor

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.

Something went wrong with that request. Please try again.