- About Hugo
- Getting Started
- Hugo Modules
-
Content Management
- Content Management Overview
- Organization
- Page Bundles
- Content Formats
- Front Matter
- Build Options
- Page Resources
- Image Processing
- Shortcodes
- Related Content
- Sections
- Content Types
- Archetypes
- Taxonomies
- Summaries
- Links and Cross References
- URL Management
- Menus
- Static Files
- Table of Contents
- Comments
- Multilingual and i18n
- Syntax Highlighting
-
Templates
- Templates Overview
- Introduction
- Template Lookup Order
- Custom Output Formats
- Base Templates and Blocks
- List Page Templates
- Homepage Template
- Section Templates
- Taxonomy Templates
- Single Page Templates
- Content View Templates
- Data Templates
- Partial Templates
- Shortcode Templates
- Local File Templates
- 404 Page
- Menu Templates
- Pagination
- RSS Templates
- Sitemap Template
- Robots.txt
- Internal Templates
- Alternative Templating
- Template Debugging
-
Functions
- Functions Quick Reference
- .AddDate
- .Format
- .Get
- .GetPage
- .HasMenuCurrent
- .IsMenuCurrent
- .Param
- .Render
- .RenderString
- .Scratch
- .Unix
- absLangURL
- absURL
- after
- anchorize
- append
- apply
- base64
- chomp
- complement
- cond
- countrunes
- countwords
- dateFormat
- default
- delimit
- dict
- echoParam
- emojify
- eq
- errorf and warnf
- fileExists
- findRE
- first
- float
- ge
- getenv
- group
- gt
- hasPrefix
- highlight
- hmac
- htmlEscape
- htmlUnescape
- hugo
- humanize
- i18n
- Image Functions
- in
- index
- int
- intersect
- isset
- jsonify
- lang.Merge
- lang.NumFmt
- last
- le
- len
- lower
- lt
- markdownify
- Math
- md5
- merge
- ne
- now
- os.Stat
- partialCached
- path.Base
- path.Dir
- path.Ext
- path.Join
- path.Split
- plainify
- pluralize
- printf
- println
- querify
- range
- readDir
- readFile
- ref
- reflect.IsMap
- reflect.IsSlice
- relLangURL
- relref
- relURL
- replace
- replaceRE
- safeCSS
- safeHTML
- safeHTMLAttr
- safeJS
- safeURL
- seq
- sha
- shuffle
- singularize
- site
- slice
- slicestr
- sort
- split
- string
- strings.Count
- strings.HasSuffix
- strings.Repeat
- strings.RuneCount
- strings.TrimLeft
- strings.TrimPrefix
- strings.TrimRight
- strings.TrimSuffix
- substr
- symdiff
- templates.Exists
- time
- title
- transform.Unmarshal
- trim
- truncate
- union
- uniq
- upper
- urlize
- urls.Parse
- where
- with
- Variables
- Hugo Pipes
- CLI
- Troubleshooting
- Tools
- Hosting & Deployment
- Contribute
- Maintenance
Releases
Hugo 0.81.0: The Smorgasbord Edition
Attribute lists (e.g. CSS classes) for Markdown blocks, newlines in template actions/blocks, native Apple M1 ARM64 binary, it’s faster, and more …
Read More »
Hugo 0.80: Last Release of 2020!
This release brings Dart Sass support, a new image overlay function, and more.
Read More »
Hugo 0.79.1: One Security Patch for Hugo on Windows
Disallow running of e.g. Pandoc in the current directory.
Read More »
Hugo 0.79.0: Black Friday Edition
Hugo 0.79.0 brings .Params to menus, snake_case support for OS environment config, and a refresh of upstream dependencies (Chroma, ESBuild etc.).
Read More »
Hugo 0.78.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.78.0.
Read More »
Hugo 0.78.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.78.0.
Read More »
Hugo 0.78.0: Full Hugo Modules Support in js.Build
Resolve JavaScript imports top-down in the layered filesystem, pass parameters from template to JS, new JS intellisense helper, improved JS build errors.
Read More »
Hugo 0.77.0: Hugo Modules Improvements and More
New Replacements config option for simpler development workflows, ignore errors from getJSON, localized dates, and more.
Read More »
Hugo 0.76.5: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.76.0.
Read More »
Hugo 0.76.4: One Bug Fix
This version fixes one more i18n regression from 0.76.0.
Read More »
Hugo 0.76.3: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.76.0.
Read More »
Hugo 0.76.1: One Bug Fix
This version fixes one bug introduced in 0.76.0.
Read More »
Hugo 0.76.2: One Bug Fix
This release reverts to an older (and working) version of the JS minifier.
Read More »
Multiple Cascades With Page Filters
Hugo 0.76.0 brings multiple cascade blocks per page with filters for path, kind and language.
Read More »
Hugo 0.75.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.75.0.
Read More »
NPM Pack
Hugo 0.75 comes with a new “hugo mod npm pack” command, several improvements re. Hugo Modules and the Node tools, and more.
Read More »
Hugo 0.74.3: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.74.0.
Read More »
Hugo 0.74.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.74.0.
Read More »
Hugo 0.74.1: A couple of Bug Fixes
This version fixes one issue introduced in 0.74.0.
Read More »
Native JS Bundler, Open API Support, Inline Partials
Hugo 0.74.0 brings blazingly fast native JavaScript bundling, with minification, tree shaking, scope hoisting for ES6 modules, and transpilation of JSX and newer JS syntax down to ES6. And more.
Read More »
Summer Breeze
Taxonomy terms cleanup, render hooks per section/type, HMAC function, and more.
Read More »
URL rewrites in dev server
Hugo 0.72.0 comes with dev server redirects and URL rewrites, Goldmark typography extension fixes, Scratch.Values.
Read More »
Markdown Render Hooks for Headings
Render hooks for headings, update to Go 1.14.3, several bug fixes etc.
Read More »
JavaScript Transpiler
Hugo 0.70.0 adds a new pipe function that uses Babel to transpile JavaScript.
Read More »
Hugo 0.69.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.69.0.
Read More »
Hugo 0.69.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.69.0.
Read More »
Post Build Resource Transformations
Hugo 0.69.0 allows you to delay resource processing to after the build, the prime use case being removal of unused CSS.
Read More »
Hugo 0.68.3: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.68.0.
Read More »
Hugo 0.68.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.68.0.
Read More »
Hugo 0.68.1: 1 bug fix
This release reverts a change in resources.ExecuteAsTemplate that broke some theme demos.
Read More »
Minify config and more!
Hugo 0.68.0 brings minify configuration and fully navigable headless sections.
Read More »
Hugo 0.67.1: A couple of Bug Fixes
This version comes with some useful bug fixes.
Read More »
Hugo 0.67.0: Custom HTTP headers
This version brings Custom HTTP headers to the development server and exclude/include filters in Hugo Deploy.
Read More »
Hugo 0.66.0: PostCSS Edition
Native inline, recursive import support in PostCSS/Tailwind, “dependency-less” builds, and more …
Read More »
Hugo 0.65.3: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.65.0.
Read More »
Hugo 0.65.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.65.0.
Read More »
0.65.0: Hugo Reloaded!
Draft, expire, resource bundling, and fine grained publishing control for any page. And it’s faster.
Read More »
Hugo 0.65.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.65.0.
Read More »
Hugo 0.64.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.64.0.
Read More »
Hugo 0.63.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.63.0.
Read More »
Hugo 0.63.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.63.0.
Read More »
Improved base templates, and faster!
In Hugo 0.63 we have improved the base template lookup logic, and this simplification also made Hugo faster …
Read More »
Hugo 0.62.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.62.0.
Read More »
Hugo 0.62.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.62.0.
Read More »
Hugo Christmas Edition!
Hugo 0.62 brings Markdown Render Hooks. And it’s faster!
Read More »
40K GitHub Stars Edition
40K stars on GitHub is a good enough reason to release a new version of Hugo!
Read More »
Hugo 0.60.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.60.0.
Read More »
Now CommonMark Compliant!
Goldmark – CommonMark compliant, GitHub flavored, fast and flexible – is the new default library for Markdown in Hugo.
Read More »
Hugo 0.59.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.59.0.
Read More »
Hugo 0.59.0
Set image target format and background color, and more …
Read More »
Hugo 0.58.3: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.58.0.
Read More »
Hugo 0.58.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.58.0.
Read More »
Hugo 0.58.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.58.0.
Read More »
Image Processing Galore!
Hugo 0.58 adds the long sought after Exif method plus many useful image filters. And it’s faster …
Read More »
Hugo 0.57.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.57.0.
Read More »
Hugo 0.57.1: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.57.0.
Read More »
Hugo 0.57: The Cascading Edition
Hugo 0.57 brings cascading front matter, alphabetical sorting, resource loading from Assets with wildcards. And it’s faster.
Read More »
Hugo 0.56.3: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.56.0.
Read More »
Hugo 0.56.2: A couple of Bug Fixes
This version fixes a couple of bugs introduced in 0.56.0.
Read More »
0.56.1: Two Bug Fixes
This version fixes a couple of regressions introduced in 0.56.0.
Read More »
Hugo 0.56.0: Hugo Modules and Deployment
This release adds powerful module support with dependency management for all component types, including content. And we now have built-in deployment support to GCS, S3, or Azure.
Read More »
Hugo 0.55.6: One Bug Fix!
Fixes some reported paginator crashes in server mode.
Read More »
Hugo 0.55.5: Take Five!
We round up this 0.55 release with a final batch of bug fixes!
Read More »
Hugo 0.55.3: A Few More Bug Fixes!
To wrap up this Easter, here is one more patch release with some important fixes.
Read More »
Hugo 0.55.2: Some Important Bug Fixes
Fixes some more issues introduced in Hugo 0.55.0.
Read More »
Hugo 0.55.0: The early Easter Egg Edition!
Faster, virtualized Output Formats, revised shortcodes, new return keyword, and much more …
Read More »
0.54.0: Mostly Bugfixes
0.54.0 is mostly a bugfix-release, but also some nice improvements.
Read More »
Hugo Christmas Edition
Hugo 0.53: Faster, config dir support, new unmarshal func, global site var, and more …
Read More »
And Now: Hugo 0.52
Configurable file caches, inline shortcodes, and more …
Read More »
Hugo 0.51: The 30K Stars Edition!
Bug fixes, new template functions and more error improvements.
Read More »
Hugo 0.50: Errors so Good, You’ll Want to Fail!
Errors with full filename and line and column number, shown in browser. And improved Fast Render Mode …
Read More »
Hugo 0.49.1: Bug Fix
This release fixes an issue where resources.Concat would sometimes fail.
Read More »
Hugo 0.49: Directory Based Archetypes
Hugo 0.49 brings archetype bundle support and collection goodness.
Read More »
This One Goes to 11!
With Go 1.11, Hugo finally gets support for variable overwrites in templates!
Read More »
Output Minification, Live-Reload Fixes and More
Hugo 0.47: Adds minification of rendered output, but is mostly a massive bug fix release.
Read More »
The Summer of Hugo
Hugo 0.46: Full SCSS/SASS import inheritance support, rework of Hugo Pipes vs. multilingual, and more …
Read More »
Hugo 0.45.1: Two Bug Fixes
Hugo 0.45.1 comes with two bug fixes … and one enhancement.
Read More »
Hugo 0.45: Revival of ref, relref and GetPage
Hugo 0.45 adds relative page lookups, language support in ref/relref and several Hugo Pipes improvements.
Read More »
Hugo 0.44: Friday the 13th Edition
A sequel to the very popular Hugo Pipes Edition; bug-fixes and enhancements …
Read More »
And Now: Hugo Pipes!
Hugo 0.43 adds a powerful and simple to use assets pipeline with SASS/SCSS and much, much more …
Read More »
Hugo 0.42.2: One Bug Fix
Hugo 0.42.2 fixes server reload on config changes.
Read More »
Hugo 0.42: Theme Composition and Inheritance!
Hugo 0.42 adds Theme Components support, a new and powerful way of composing your Hugo sites.
Read More »
Hugo 0.41: Privacy Configuration for GDPR
Hugo 0.41 adds a new site configuration section to meet the new General Data Protection Regulation (GDPR).
Read More »
Hugo 0.40.3: One Bug Fix
Fixes a rare, but possible Content truncation issue.
Read More »
Hugo 0.40: The Revival of the Shortcodes
Hugo 0.40: Shortcodes with
.Content
(almost) always available, processed in order of appearance, several new template funcs …
Read More »
Hugo 0.39: The Nat King Cole Stabilizer Edition
Hugo 0.39: Rewrite of the /commands package,
Resource.Content
, several new template funcs, and more …
Read More »
Hugo 0.38.2: Two Bugfixes
0.38.2 fixes
--contentDir
flag handling and “.” in content filenames.
Read More »
Hugo 0.38.1: Some Live Reload Fixes
Hugo 0.38.1 fixes some live reload issues introduced in 0.38.
Read More »
Hugo 0.38: The Easter Egg Edition
Hugo 0.38: Date and slug from filenames, multiple content dirs, config from themes, language merge func …
Read More »
Hugo 0.37.1: One Bugfix
Fixes SVG (and similar) handling as page resources.
Read More »
Hugo 0.37: Preserve PNG Colour Palette
Reduces processed PNG file sizes. And 0.37 is built with Go 1.10!
Read More »
Hugo 0.36: Smart Image Cropping!
Hugo 0.36 announces smart image cropping and some important bug fixes.
Read More »
Hugo 0.35: Headless Bundles!
Headless Bundles, disable languages, improves fast render mode, and much more.
Read More »
Hugo 0.34: Pattern matching to filter images and other resources
Hugo 0.34 adds full glob with super-asterisk support, for example
*.jpg
.
Read More »
Hugo 0.33: The New Kinder Surprise!
Hugo 0.33 comes with resource (images etc.) metadata,
type
and layout
for all page types, url
in front matter for list pages …
Read More »
Hugo 0.32.4: Two bugfixes
Fixes non-ASCII path handling for Page resources.
Read More »
Hugo 0.32.3: Some important bug fixes
Fixes multilingual resource (images etc.) handling etc.
Read More »
Hugo 0.32.2: One bugfix
Fixes one issue with publishing of processed images when no cache.
Read More »
Hugo 0.32: Page Bundles and Image Processing!
Images and other resources with page-relative links, resize, scale and crop images, and much more.
Read More »
Hugo 0.31: Language Multihost Edition!
Hugo 0.31: Multihost, smart union static dirs, and more …
Read More »
Hugo 0.30.2: One More Bugfix
Fixes Fast Render mode when having sub-path in
baseURL
.
Read More »
Hugo 0.30.1: Two Important Bugfixes!
Fixes
hugo -w
and validator-broken Sitemap.
Read More »
Hugo 0.29: Template Metrics
Makes it easy to find template bottle necks.
Read More »
Hugo 0.28: High-speed Syntax Highlighting!
Chroma is the new default syntax highlighter in Hugo.
Read More »
Hugo 0.27.1: One bugfix
Hugo 0.27.1 fixes an issue introduced in Go 1.9 with HTML escaping of shortcodes in multi output sites.
Read More »
Hugo 0.27: Fast and Flexible Related Content!
Makes it easy to add “See Also” sections etc. to your site.
Read More »
Hugo 0.26: Language Style Edition
Hugo 0.26 brings proper AP Style or Chicago Style Title Case, « French Guillemets » and more.
Read More »
Hugo 0.25
Hugo 0.25 automatically opens the page you're working on in the browser
Read More »
Hugo 0.24.1
This release fixes some important archetype-related regressions from Hugo 0.24
Read More »
Hugo 0.23
Hugo 0.23 is mainly a release that handles all the small changes needed to get Hugo moved to a GitHub organisation
Read More »
Hugo 0.22.1
Hugo 0.22.1 fixes a couple of issues reported after the 0.22 release
Read More »
Hugo 0.22
Hugo 0.22 brings nested sections, by popular demand and a long sought after feature
Read More »
Hugo 0.21
Hugo 0.21 brings full support for shortcodes per Output Format, the last vital piece of that puzzle
Read More »
Hugo 0.20.7
This just fixes an issue with the release scripts, no change in the binaries
Read More »
Hugo 0.20.6
There have been some shouting on discuss.gohugo.io about some broken sites after the release of Hugo 0.20. This release reintroduces the old behaviour, making /my-blog-post/index.md work as expected.
Hugo now has:
16675+ stars 456+ contributors 156+ themes Fixes Avoid index.md in /index/index.html #3396 Make missing GitInfo a WARNING b30ca4be @bep #3376 Fix some of the fpm fields for deb 3bd1d057 @anthonyfok
Read More »
Hugo 0.20.5
This is a bug-fix release which fixes the version number of 0.20.4 (which wrongly shows up as 0.21-DEV) (#3388).
Read More »
Hugo 0.20.4
This is the second bug-fix release of the day, fixing a couple of issues related to the new release scripts
Read More »
Hugo 0.20.3
This is a bug-fix release with one important fix. But it also adds some harness around GoReleaser
Read More »
Hugo 0.20.2
Hugo 0.20.2 adds support for plain text partials included into HTML templates
Read More »
Hugo 0.20.1
Hugo 0.20.1 is a bug fix release, fixing some important regressions introduced in 0.20
Read More »
Hugo 0.20
Hugo 0.20 introduces the powerful and long sought after feature Custom Output Formats
Read More »
Hugo 0.19
Hugo 0.19 brings native Emacs Org-mode content support, and Hugo has its own Twitter account
Read More »
Hugo 0.18
The primary new feature in Hugo 0.18 is that every piece of content is now a Page.
Read More »
0.17: Hugo is going global
Hugo now supports multilingual sites with the most simple and elegant experience.
Read More »
Hugo 0.16
Hugo 0.16 is our best and biggest release ever. The Hugo community has outdone itself with continued performance improvements, beautiful themes and increased stability.
Read More »
Hugo 0.15
The v0.15.0 Hugo release brings a lot of polish to Hugo. Exactly 6 months after the 0.14 release, Hugo has seen massive growth and changes. Most notably, this is Hugo’s first release under the Apache 2.0 license.
Read More »
Hugo 0.14
The v0.14.0 Hugo release brings of the most demanded features to Hugo. The foundation of Hugo is stabilizing nicely and a lot of polish has been added. We’ve expanded support for additional content types with support for AsciiDoc, Restructured Text, HTML and Markdown.
Read More »
Hugo 0.13
Hugo 0.13 is the largest Hugo release to date. The release introduced some long sought after features (pagination, sequencing, data loading, tons of template improvements) as well as major internal improvements. In addition to the code changes, the Hugo community has grown significantly and now has over 3000 stars on GitHub, 134 contributors, 24 themes and 1000s of happy users.
Read More »
Hugo 0.12
Hugo 0.12 focused on polishing the theme engine and adding critical functionality to the templates.
Read More »
Hugo 0.11
Now 3–4 times faster, Hugo 0.11 brings live reload, theme engine, menu system, XML sitemap, and more!
Read More »
Hugo 0.10
Hugo 0.10 brings syntax highlighting (powered by Pygments), automatic table of contents generation, support for Unicode, and a lot more!
Read More »
Hugo 0.9
Hugo 0.9 is the most significant update to Hugo ever! It contains contributions from dozens of contributors and represents hundreds of features, fixes and improvements.
Read More »
Hugo 0.8
Hugo 0.8 added support for pretty URLs, support for TOML and YAML, better Windows compatibility, and more!
Read More »