Hugo Documentation

A fast and flexible static site generator built with love by bep, spf13, and friends in Go.

Hugo is optimized for speed and designed for flexibility. With its advanced templating system and fast asset pipelines, Hugo renders a complete site in seconds, often less.

Below you will find some of the most common and helpful pages from our documentation.

Introduction to templating

Create templates to render your content, resources, and data. Read More »

Content organization

Hugo assumes that the same structure that works to organize your source content is used to organize the rendered site. Read More »

Directory structure

Each Hugo project is a directory, with subdirectories that contribute to the content, structure, behavior, and presentation of your site. Read More »

Configure Hugo

How to configure your Hugo site. Read More »

Template lookup order

Hugo uses the rules below to select a template for a given page, starting from the most specific. Read More »

Base templates

The base and block construct allows you to define the outer shell of your master templates (i.e., the chrome of the page). Read More »

Configure markup

Configure rendering of markup to HTML. Read More »

Configure build

Configure global build options. Read More »

Build options

Build options help define how Hugo must treat a given page when building the site. Read More »

Image processing

Resize, crop, rotate, filter, and convert images. Read More »

Custom output formats

Hugo can output content in multiple formats, including calendar events, e-book formats, Google AMP, and JSON search indexes, or any custom text format. Read More »