Hugo: Site Hierarchy

Hugo websites let you organize content by sections and taxonomy terms.

section
a folder with _index file; structured, hierarchical grouping
taxonomy
a list field in the front matter; can be defined in config.toml; cross-sectional, attributive grouping; categories and tags are default taxonomies
term
elements in the taxonomy list in the front matter; defined by use in front matter; e.g., the different categories or tags used on the website
value
content (e.g., page) assigned to a term

This means that pages can be part of a section and have several terms assigned. One may use both to classify the content. For instance, I have a section called “blog” and all pages inside have one or more categories (terms) assigned. So, I can list all pages under section “blog” or all articles under category (term) “Code”.

The organization of content by sections and terms is better explained by the following diagram.

structural diagram of a Hugo website
Structure of a Hugo website. Source: Hugo docs (archived).