Skip to main content
  1. X-GOVUK projects
  2. GOV.UK Eleventy Plugin

Adding a site search

Make it easier for readers to find content on your site.

The GOV.UK Eleventy Plugin makes it easy to add search functionality to your website. Follow these instructions to enable this feature.

Create a search index

The site search needs an index of your pages and the key words and phrases they contain.

Create the search index by creating a page that uses the search-index layout:

eleventyExcludeFromCollections: true
layout: search-index
permalink: /search.json

The permalink value is the location of the generated file.

Create a sitemap

The search feature only works if JavaScript is available, but falls back to a link to a sitemap.

Create the search index by creating a page that uses the sitemap layout:

eleventyExcludeFromCollections: true
layout: sitemap
permalink: /sitemap

You can see an example of a sitemap on this website.

Add a search input to the site header

Add the permalink values to the corresponding plugin options for For example:

const govukEleventyPlugin = require('@x-govuk/govuk-eleventy-plugin')

module.exports = function(eleventyConfig) {
  eleventyConfig.addPlugin(govukEleventyPlugin, {
    header: {
      search: {
        indexPath: '/search.json',
        sitemapPath: '/sitemap'