Skip to main content
Blowfish Blowfish


Simple, yet powerful. Learn how to use Blowfish and its features.

Featured Blowfish image

This section contains everything you need to know about Blowfish. If you’re new, check out the Installation guide to begin or visit the Samples section to see what Blowfish can do.

Welcome to Blowfish 🐡

3 mins·0 views· 0 likes new docs
Blowfish is packed with tons of features. The original aim of Blowfish was to develop a theme that was simple and lightweight. The theme is a fork of Congo and expands its initial vision.


5 mins·0 views· 0 likes installation docs
Simply follow the standard Hugo Quick Start procedure to get up and running quickly. Detailed installation instructions can be found below. Instructions for updating the theme are also available. Installation # These instructions will get you up and running using Hugo and Blowfish from a completely blank state.

Getting Started

5 mins·0 views· 0 likes installation docs
This section assumes you have already installed the Blowfish theme. The config files that ship with Blowfish contain all of the possible settings that the theme recognises. By default, many of these are commented out but you can simply uncomment them to activate or change a specific feature.


12 mins·0 views· 0 likes config docs
Blowfish is a highly customisable theme and uses some of the latest Hugo features to simplify how it is configured. The theme ships with a default configuration that gets you up and running with a basic blog or static website.

Homepage Layout

3 mins·0 views· 0 likes homepage layouts docs
Blowfish provides a fully flexible homepage layout. There are two main templates to choose from with additional settings to adjust the design. Alternatively, you can also provide your own template and have complete control over the homepage content.


1 min·0 views· 0 likes thumbnail config docs
Thumbnails # Blowfish was enhanced in order to make it easy to add visual support to your posts. To do so, you just need to place an image file (almost all formats are supported bue we recommend .

Front Matter

3 mins·0 views· 0 likes front matter config docs
In addition to the default Hugo front matter parameters, Blowfish adds a number of additional options to customise the presentation of individual articles. All the available theme front matter parameters are listed below.


5 mins·0 views· 0 likes shortcodes mermaid icon lead docs
In addition to all the default Hugo shortcodes, Blowfish adds a few extras for additional functionality. Alert # alert outputs its contents as a stylised message box within your article. It’s useful for drawing attention to important information that you don’t want the reader to miss.


4 mins·0 views· 0 likes partials analytics privacy comments favicons icon docs
Analytics # Blowfish provides built-in support for Fathom Analytics and Google Analytics. Fathom is a paid alternative to Google Analytics that respects user privacy. Fathom Analytics # To enable Fathom Analytics support, simply provide your Fathom site code in the config/_default/params.

Content Examples

10 mins·0 views· 0 likes content example
If you’ve been reading the documentation in order, you should now know about all the features and configurations available in Blowfish. This page is designed to pull everything together and offer some worked examples that you might like to use in your Hugo project.

Advanced Customisation

8 mins·0 views· 0 likes advanced css docs
There are many ways you can make advanced changes to Blowfish. Read below to learn more about what can be customised and the best way of achieving your desired result.

Hosting & Deployment

4 mins·0 views· 0 likes hosting deployment docs github netlify render
There are many ways to deploy your Hugo website built with Blowfish. The theme is designed to be flexible in almost any deployment scenario. Blowfish is built using relative URLs throughout the theme.

Firebase: Views & Likes

2 mins·0 views· 0 likes firebase views likes
In order to be able to support dynamic data across your website we’ve added the support to integrate Firebase. This will allow you to use the views feature across lists and posts.