We did not switch the roles of “taxonomy.html” and “term.html” (singular). Their functions remain the same.
However, we did change how Hugo handles situations where both “taxonomy.html” and “terms.html” (plural) are present in the same directory.
Before version 0.146.0, the lookup rules were a bit complicated due to backward compatibility efforts with older versions (specifically v0.72.0 and earlier). In short:
- If both “taxonomy.html” and “terms.html” (plural) were in the same directory:
- “terms.html” (plural) was used to render taxonomy pages.
- “taxonomy.html” was used to render term pages.
- If only “taxonomy.html” was present, it rendered taxonomy pages as expected.
With v0.146.0 and later:
- Never create a “terms.html” (plural) template
- “taxonomy.html” always renders a taxonomy page; it never renders a term page.