Here are documented the special options that you can set when creating a new DocxGen to get some more superpower :

It documents the options parameter when you do:

new DocxGen(data,options);

Image Replacing

The name of this option is qrCode (function) (This was a boolean in 0.6.3 and before).

To stay a templating engine, I wanted that DocxTemplater doesn’t add an image from scratch, but rather uses an existing image that can be detected, and DocxTemplater will just change the contents of that image, without changing it’s style (border, shades, ...). The size of the replaced images will stay the same, ...

So I decided to use the qrCode format, which is a format that lets you identify images by their content.

The option for this is qrCode (false for off, a function for on, default off)

The function takes two parameter: The first one is the string, the second the callback.

For example your configuration could be:

new DocxGen(data,{qrCode:function(result,callback){
            options =
                    method: 'GET'
            errorCallback= (e) ->
                    throw new Error("Error on HTTPS Call")
            reqCallback= (res)->
                    data = ""
                    res.on('data', (chunk)->
                            data += chunk
                    res.on('end', ()->
            req = http.request(options, reqCallback).on('error',errorCallback)


If you don’t use that functionality, you should disable it, because it is quite slow (the image decoding)


The qrCode functionality only works for PNG ! They is no support for other file formats yet. The main problem being that their is no decoder for other file formats in Node.js The library does support decoding for more file formats (gif, png, jpeg), but depends on 3 other none node dependencies.


They is a security warning if you use true as the value for qrCode, because this will use the older qrcode loading function. This function can load any file on the filesystem, with a possible leak in api-keys or whatever you store on docxtemplater’s server.

To generate qrcodes with nodejs, you can use for example this script brought by @ssured in issue #69

npm install qr-image canvas

To install the dependencies of canvas, look here (platform specific)

var Canvas, Image, canvas, column, ctx, fs, matrix, qr, qrString, size, textSize, value, x, y, _i, _j, _len, _len1;
qr = require('qr-image');
fs = require('fs');
Canvas = require('canvas');
Image = Canvas.Image;
qrString = 'gen:{image}';
size = 10;
matrix = qr.matrix(qrString);
canvas = new Canvas((2 + 5 + matrix.length) * size, (2 + 5 + matrix.length) * size);
ctx = canvas.getContext('2d');
ctx.fillStyle = '#000';
ctx.fillRect(0, 0, canvas.width, canvas.height);
ctx.fillStyle = '#fff';
ctx.fillRect(1, 1, canvas.width - 2, canvas.height - 2);
ctx.fillStyle = '#000';
for (y = _i = 0, _len = matrix.length; _i < _len; y = ++_i) {
  column = matrix[y];
  for (x = _j = 0, _len1 = column.length; _j < _len1; x = ++_j) {
    value = column[x];
    if (value === 1) {
      ctx.fillRect((x + 1 + 2.5) * size, (y + 1) * size, size, size);
ctx.font = 4 * size + 'px Helvetica';
ctx.fillStyle = '#000';
textSize = ctx.measureText(qrString);
ctx.fillText(qrString, (canvas.width - textSize.width) / 2, canvas.height - size - textSize.actualBoundingBoxDescent);

Angular Parser

The name of this option parser (function).

You can set the angular parser with the following code:

With a custom parser you can parse the tags to for example add operators like ‘+’, ‘-‘, or whatever the way you want to parse expressions. See for a complete reference of all possibilities

To enable this, you need to specify a custom parser. You need to create a parser function:

docxtemplater comes shipped with this parser:

    return {
        get:function(scope) {
            return scope[expression]

To use the angular-parser, do the following:

expressions= require('angular-expressions');
// define your filter functions here, eg:
// expressions.filters.split = function(input, str) { return input.split(str); }
angularParser= function(tag) {
    return {
        get: tag == '.' ? function(s){ return s;} : expressions.compile(tag)
new DocxGen(data,{parser:angularParser})


The require() works in the browser if you include vendor/angular-parser-browser.js

Intelligent LoopTagging

The name of this option intelligentTagging (boolean).

When looping over an element, docxtemplater needs to know over which element you want to loop. By default, it tries to do that intelligently (by looking what XML Tags are between the {tags}). However, if you want to always use the <w:t> tag by default, set this option to false.

You can always specify over which element you want to loop with the dash loop syntax