configuration-render.md

title	description
API: The render Property	Nuxt.js lets you customize runtime options for rendering pages

The render Property

Nuxt.js lets you customize runtime options for rendering pages

bundleRenderer

• Type: Object

Use this option to customize vue SSR bundle renderer. This option is skipped for spa mode.

module.exports = {
  render: {
    bundleRenderer: {
      directives: {
        custom1: function (el, dir) {
          // something ...
        }
      }
    }
  }
}

Learn more about available options on Vue SSR API Reference. It is recommended to not use this option as Nuxt.js is already providing best SSR defaults and misconfiguration might lead to SSR problems.

etag

• Type: Object
  • Default: { weak: true }

To disable etag for pages set etag: false

See etag docs for possible options.

compressor

• Type Object
  • Default: { threshold: 0 }

When providing an object (or a falsy value), the compression middleware will be used (with respective options).

If you want to use your own compression middleware, you can reference it directly (f.ex. otherComp({ myOptions: 'example' })).

http2

• Type Object
  • Default: { push: false }

Activate HTTP2 push headers.

resourceHints

• Type: boolean
  • Default: true

Adds prefetch and preload links for faster initial page load time.

You may want to only disable this option if have many pages and routes.

ssr

• Type: boolean
  • Default: true on universal mode and false on spa mode

Enable SSR rendering

This option is automatically set based on mode value if not provided. This can be useful to dynamically enable/disable SSR on runtime after image builds. (With docker for example)

static

• Type: Object
  • Default: {}

See serve-static docs for possible options.

dist

• Type: Object
  • Default: { maxAge: '1y', index: false }

The options used for serving distribution files. Only applicable in production.

See serve-static docs for possible options.

csp

Use this to configure to load external resources of Content-Security-Policy

• Type: Boolean or Object
  • Default: false

Example (nuxt.config.js)

export default {
  render: {
    csp: true
  }
}

// OR

export default {
  render: {
    csp: {
      hashAlgorithm: 'sha256',
      allowedSources: undefined,
      policies: undefined
    }
  }
}