Skip to main content


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

Screenshots of Congo on an iPhone, iPad and MacBook

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

Special thanks to Katerina Limpitsouni for the excellent illustrations that are used throughout these docs!

What's New in 2.0 ✨

4 mins
Version 2 takes Congo to new heights, making the theme even more powerful while still maintaining its lightweight footprint.


5 mins
Learn how to get up and running using Hugo and Congo from a completely blank state. It’s the best place to start if you’re a new user.

Getting Started

7 mins
This section assumes you have already installed the Congo theme and are ready to start with basic configuration tasks like selecting a colour scheme, menu and content structure.


12 mins
Discover all the site, language and theme configurations that are available in Congo and how they can be used to customise your project.

Homepage Layout

3 mins
Congo provides a fully flexible homepage layout with built-in templates and the ability to provide your own.

Front Matter

3 mins
While supporting most Hugo defaults, Congo adds a number of front matter parameters to customise the presentation of individual articles.


5 mins
Congo includes several shortcodes for adding rich content to articles including images, charts, diagrams, buttons and more.


4 mins
Partials are used to add special functionality to the theme including analytics, comments, favicons, custom scripts and more.

Content Examples

10 mins
It’s time to bring everything together with some examples that demonstrate how content should be created and structured.

Advanced Customisation

8 mins
Congo supports advanced customisations that include modifying the underlying Tailwind configuration, building the theme manually and providing custom CSS.

Hosting & Deployment

4 mins
Congo is designed to be flexible in almost any deployment scenario. Learn more about how to deploy your project to some common hosting platforms.