Introduction

Create templates to render your content, resources, and data.

Organization

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

Directory structure

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

Lookup order

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

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).

Configuration

How to configure your Hugo site.

Configure markup

Configure rendering of markup to HTML.

Build options

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

Configure build

Configure global build options.

Image processing

Resize, crop, rotate, filter, and convert images.

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.