Handlebars – Must pass iterator to each (Error)

If you’re starting out with Handlebars and using it to create your HTML web pages, you may come across an oblique error message which may not make too much sense.

One such error you may encounter returns the following response:

throw new Exception(‘Must pass iterator to #each’)

To solve this problem you need to locate within your Handlebars template code an {{#each}} call.

For example, you may have something like this in your code where it is intended to loop through something and fetch the url and the link and output them as an anchor tag:

    <a href="{{uri}}"">{{link}}</a>


To solve this problem, with every {{#each}} call in your template amend it to {{#each .}} . If you missed it, there’s a space after the word each followed by a . (dot). This . dot sets the context of each to whatever you’ve passed in to the template.

Therefore, our example code above should now look like this:

{{#each .}}
    <a href="{{uri}}"">{{link}}</a>

Once you’ve made this amendment you shouldn’t have this error any longer.

Photo of author
Ryan Sheehy
Ryan has been dabbling in code since the late '90s when he cut his teeth exploring VBA in Excel. Having his eyes opened with the potential of automating repetitive tasks, he expanded to Python and then moved over to scripting languages such as HTML, CSS, Javascript and PHP.