Skip to Content

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.