@nuxtjs/sitemap

Sitemap

Automatically generate or serve dynamic sitemap.xml for Nuxt.js projects!

Module based on the awesome sitemap package ❤️

Setup

• Add @nuxtjs/sitemap dependency using yarn or npm to your project
• Add @nuxtjs/sitemap module to nuxt.config.js

  modules: [
   '@nuxtjs/sitemap'
  ]

• Add additional options to sitemap section of nuxt.config.js to override defaults

  sitemap: {
    path: '/sitemap.xml',
    hostname: 'https://example.com',
    cacheTime: 1000 * 60 * 15,
    generate: false, // Enable me when using nuxt generate
    exclude: [
      '/secret',
      '/admin/**'
    ]
    routes: [
      '/page/1',
      {
        url: '/page/2',
        changefreq: 'daily',
        priority: 1,
        lastmodISO: '2017-06-30T13:30:00.000Z'
      }
    ]
  }

Options

exclude

The exclude parameter is an array of glob patterns to exclude static routes from the generated sitemap.

routes

The routes parameter follows the same way than the generate configuration.

See as well the #routes examples below.

path

• Default: /sitemap.xml

Where serve/generate sitemap file

hostname

• Default:
  • hostname() for generate mode
  • Dynamically based on request url for middleware mode

This values is mondatory for generation sitemap file, and you should explicitly provide it for generate mode.

generate

• Default: false

Generates static sitemap file during build/generate instead of serving using middleware.

cacheTime

• Default: 1000 * 60 * 15 (15 Minutes)

Defines how friequently should sitemap routes being updated. This option is only effective when generate is false. Pleae note that after each invalidation, routes will be evalouated again. (See #routes section)

Routes

Dynamic routes are ignored by the sitemap module.

Example:

-| pages/
---| index.vue
---| users/
-----| _id.vue

If you want the module to add routes with dynamic params, you need to set an array of dynamic routes.

We add routes for /users/:id in nuxt.config.js:

  sitemap: {
    routes: [
      '/users/1',
      '/users/2',
      '/users/3'
    ]
  }

Function which returns a Promise

nuxt.config.js

const axios = require('axios')

module.exports = {
  sitemap: {
    routes () {
      return axios.get('https://jsonplaceholder.typicode.com/users')
      .then(res => res.data.map(user =>  '/users/' + user.username))
    }
  }
}

Function with a callback

nuxt.config.js

const axios = require('axios')

module.exports = {
  sitemap: {
    routes (callback) {
      axios.get('https://jsonplaceholder.typicode.com/users')
      .then(res => {
        let routes = res.data.map(user => '/users/' + user.username)
        callback(null, routes)
      })
      .catch(callback)
    }
  }
}

Contributors

• Nicolas PENNEC
• Pooya Parsa