How to implement search in Hugo

Photo by Fotis Fotopoulos on Unsplash

Update config.toml file

Add this snippet to your config.toml file to instruct Hugo to create the index file in JSON format. (RSS and HTML are default outputs, what’s important is to add JSON.

home = ["HTML", "RSS", "JSON"]

Create layouts/_default/index.json file

Add the following index.json template to specified folder.

{{- $.Scratch.Add "index" slice -}}
{{- range .Site.RegularPages -}}
{{- $.Scratch.Add "index" (dict "title" .Title "tags" .Params.tags "categories" .Params.categories "contents" .Plain "permalink" .Permalink) -}}
{{- end -}}
{{- $.Scratch.Get "index" | jsonify -}}

Create static/js/search.js file

This file uses jquery, fuse.js, mark.js to search the hugo created index, and return matching content, with highlighting.

var fuseOptions = {
shouldSort: true,
includeMatches: true,
threshold: 0.0,
location: 0,
distance: 100,
maxPatternLength: 32,
minMatchCharLength: 1,
keys: [

var searchQuery = param("s");
}else {
$('#search-results').append("<p>Please enter a word or phrase above</p>");

function executeSearch(searchQuery){
$.getJSON( "/index.json", function( data ) {
var pages = data;
var fuse = new Fuse(pages, fuseOptions);
var result =;
if(result.length > 0){
$('#search-results').append("<p>No matches found</p>");

function populateResults(result){
var contents= value.item.contents;
var snippet = "";
var snippetHighlights=[];
var tags =[];
if( fuseOptions.tokenize ){
if(mvalue.key == "tags" || mvalue.key == "categories" ){
}else if(mvalue.key == "contents"){
start = mvalue.indices[0][0]-summaryInclude>0?mvalue.indices[0][0]-summaryInclude:0;
end = mvalue.indices[0][1]+summaryInclude<contents.length?mvalue.indices[0][1]+summaryInclude:contents.length;
snippet += contents.substring(start,end);

snippet += contents.substring(0,summaryInclude*2);
//pull template from hugo templarte definition
var templateDefinition = $('#search-result-template').html();
//replace values
var output = render(templateDefinition,{key:key,title:value.item.title,link:value.item.permalink,tags:value.item.tags,categories:value.item.categories,snippet:snippet});



function param(name) {
return decodeURIComponent(( + '=')[1] || '').split('&')[0]).replace(/\+/g, ' ');

function render(templateString, data) {
var conditionalMatches,conditionalPattern,copy;
conditionalPattern = /\$\{\s*isset ([a-zA-Z]*) \s*\}(.*)\$\{\s*end\s*}/g;
//since loop below depends on re.lastInxdex, we use a copy to capture any manipulations whilst inside the loop
copy = templateString;
while ((conditionalMatches = conditionalPattern.exec(templateString)) !== null) {
//valid key, remove conditionals, leave contents.
copy = copy.replace(conditionalMatches[0],conditionalMatches[2]);
//not valid, remove entire section
copy = copy.replace(conditionalMatches[0],'');
templateString = copy;
//now any conditionals removed we can do simple substitution
var key, find, re;
for (key in data) {
find = '\\$\\{\\s*' + key + '\\s*\\}';
re = new RegExp(find, 'g');
templateString = templateString.replace(re, data[key]);
return templateString;

Create content/ file

title: "Search Results"
priority : 0.1
layout: "search"

Nothing on this page will be visible. This file exists solely to respond to /search URL.

Setting a very low sitemap priority will tell search engines this is not important content.

Create layouts/_default/search.html file

{{ define "footerfiles" }}
<script src=""></script>
<script src=""></script>
<script src=""></script>
<script src="{{ "js/search.js" | absURL }}"></script>
{{ end }}
{{ define "main" }}
<section class="resume-section p-3 p-lg-5 d-flex flex-column">
<div class="my-auto" >
<form action="{{ "search" | absURL }}">
<input id="search-query" name="s"/>
<div id="search-results">
<h3>Matching pages</h3>
<!-- this template is sucked in by search.js and appended to the search-results div above. So editing here will adjust style -->
<script id="search-result-template" type="text/x-js-template">
<div id="summary-${key}">
<h4><a href="${link}">${title}</a></h4>
${ isset tags }<p>Tags: ${tags}</p>${ end }
${ isset categories }<p>Categories: ${categories}</p>${ end }
{{ end }}





I drink a lot of tea and build beautiful websites. If you are looking to work together or just start a conversation 👉

Love podcasts or audiobooks? Learn on the go with our new app.

Recommended from Medium

An Analysis of React Redux Express Pattern

From JavaScript to Node JS

Login in with Google inside your ReactJS Application.

Want to Automate Code Reviews? Set Up Danger JS for Unsupported CIs

How to turn ugly Java APIs into elegant, type-safe Scala APIs

What’s new in redux-toolkit 1.8.0 release

8 Marvelous UI Components For Your Design Inspiration 🎨😍

Title Image

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Ronalds Vilcins

Ronalds Vilcins

I drink a lot of tea and build beautiful websites. If you are looking to work together or just start a conversation 👉

More from Medium

What is JWT. How to implement JWT based authentication in NodeJs?

How to implement JWT based authentication in NodeJs

Beginners guide to authentication and authorization in the Client-Server model.

Dynamically add and view data using React hooks — useState, useEffect, useRef