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 1,000,000+ packages pre-installed, including gulp-ejs with all npm packages installed. Try it out:

var gulpEjs = require("gulp-ejs")

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

gulp-ejs v5.1.0

A plugin for Gulp that parses ejs template files

gulp-ejs NPM version Build Status Dependency Status

ejs plugin for gulp


First, install gulp-ejs as a development dependency:

npm install --save-dev gulp-ejs

Then, add it to your gulpfile.js:

var ejs = require("gulp-ejs")

        msg: "Hello Gulp!"

Watch mode error handling (for gulp v3 or below)

If you want to use gulp-ejs in a watch/livereload task, you may want to avoid gulp exiting on error when, for instance, a partial file is ENOENT or an ejs syntax error.

Here's an example on how to make it work:

var ejs = require('gulp-ejs')
var log = require('fancy-log')

        msg: 'Hello Gulp!'
    }).on('error', log))

This will make gulp log the error and continue normal execution.

Please note that you don't need to do this for Gulp v4.

Accessing the ejs object

The ejs object is also exported and you can use it to configure ejs:

const ejs = require('gulp-ejs')

ejs.__EJS__.fileLoader = function () { /* custom file loader */ }

Note: As of version 4, the exported ejs object was renamed from ejs to __EJS__.

Async rendering (requires runtime support)

Since ejs v2.5.8 added support for promise/async-await renderFile, you can now use this option with gulp-ejs v4.1.0.

You can use async/await in your ejs templates by passing { async: true } in the ejs options hash:

const ejs = require('gulp-ejs')

async function foobar() { /* async task */ }

    .pipe(ejs({ foobar }, { async: true }))

Then in your templates use await to call async functions. Here's an example:

<%= await foobar() %>


ejs(data, options)


Type: hash Default: {}

A hash object where each key corresponds to a variable in your template.

Note: As of v1.2.0, is supported as a way of passing data into ejs. See this. If both and data are passed, they are merged (data works as default for ejs options and overrides it.)


Type: hash Default: {}

A hash object for ejs options.

For more info on ejs options, check the project's documentation.

Renaming file extensions

As of version 4, the third api parameter settings was removed. You can no longer provide an extension. This is because it falls out of the scope of gulp-ejs. So if you need to save the file with a different extension you can use gulp-rename.

Here's an example for template files with .ejs extension that are rendered into .html files:

const ejs = require('gulp-ejs')
const rename = require('gulp-rename')

  .pipe(ejs({ title: 'gulp-ejs' }))
  .pipe(rename({ extname: '.html' }))


MIT License

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