jmopines/site/content/config/taxonomies.md

title	date	draft	tags
Using Tags and Categories	2026-04-01	false	hugo meta

Hugo ships with two default taxonomies: tags and categories.

Assigning terms

Add them to any article's front matter:

---
title: "My Article"
tags: ['python', 'tools']
categories: ['tutorials']
---

What Hugo generates

For each taxonomy, Hugo creates:

• A taxonomy list page: /tags/ — shows all terms.
• A term page per value: /tags/python/ — lists all articles with that tag.

Custom taxonomies

Define additional taxonomies in hugo.toml:

[taxonomies]
  tag = "tags"
  category = "categories"
  series = "series"

Then use series: ['my-series'] in front matter. Hugo generates /series/ and /series/my-series/ automatically.

Tag overlap

Tags are meant to cross-cut sections. An article in software/ and one in config/ can share the tag hugo — the term page at /tags/hugo/ will list both.