THE WORLD’S FASTEST FRAMEWORK FOR BUILDING WEBSITES May 2, 2021 This version fixes an issue introduced in 0.83.0. May 1, 2021 WebP image encoding support, some important i18n fixes, and more. April 20, 2021 This version fixes a bug introduced in 0.82.0. March 21, 2021 Mostly bug fixes, but

BASIC USAGE

Deploy Your Website . After running hugo server for local web development, you need to do a final hugo run without the server part of the command to rebuild your site. You may then deploy your site by copying the public/ directory to your production web server.. Since Hugo generates a static website, your site can be hosted anywhere using any web server. See Hosting and Deployment for

HUGO DOCUMENTATION

Hugo is the world’s fastest static website engine. It’s written in Go (aka Golang) and developed by bep, spf13 and friends.. Below you will find some of the most

QUICK START

The above will create a new Hugo site in a folder named quickstart.. Step 3: Add a Theme . See themes.gohugo.io for a list of themes to consider. This quickstart uses the beautiful Ananke theme.. First, download the theme from GitHub and add it to your site’s themes

directory:

HUGO NEW SITE

hugo new site Create a new site (skeleton) Synopsis Create a new site in the provided directory. The new site will have the correct structure, but no content or theme yet. Use hugo new to create new content. hugo new site Options --force init inside non-empty directory -f, --format string config & frontmatter format (default "toml") -h, --help help for site Options

PAGE RESOURCES

SASS / SCSS

Options transpiler New in v0.80.0 The transpiler to use, valid values are libsass (default) and dartsass.Note that the Embedded Dart Sass project is still in beta (beta 5 at the time of writing). The release is scheduled for Q1 2021.

.GETPAGE | HUGO

.GetPage and Multilingual Sites . The previous examples have used the full content filename to lookup the post. Depending on how you have organized your content (whether you have the language code in the file name or not, e.g. my-post.en.md), you may want to do the lookup without extension.This will get you the current language’s version

of the page:

COMPLETE LIST

Okayish Blog Hugo Theme. casper3. Ticky Tacky Dark

EDUCENTER HUGO

THE WORLD’S FASTEST FRAMEWORK FOR BUILDING WEBSITES May 2, 2021 This version fixes an issue introduced in 0.83.0. May 1, 2021 WebP image encoding support, some important i18n fixes, and more. April 20, 2021 This version fixes a bug introduced in 0.82.0. March 21, 2021 Mostly bug fixes, but

BASIC USAGE

Deploy Your Website . After running hugo server for local web development, you need to do a final hugo run without the server part of the command to rebuild your site. You may then deploy your site by copying the public/ directory to your production web server.. Since Hugo generates a static website, your site can be hosted anywhere using any web server. See Hosting and Deployment for

HUGO DOCUMENTATION

Hugo is the world’s fastest static website engine. It’s written in Go (aka Golang) and developed by bep, spf13 and friends.. Below you will find some of the most

QUICK START

The above will create a new Hugo site in a folder named quickstart.. Step 3: Add a Theme . See themes.gohugo.io for a list of themes to consider. This quickstart uses the beautiful Ananke theme.. First, download the theme from GitHub and add it to your site’s themes

directory:

HUGO NEW SITE

hugo new site Create a new site (skeleton) Synopsis Create a new site in the provided directory. The new site will have the correct structure, but no content or theme yet. Use hugo new to create new content. hugo new site Options --force init inside non-empty directory -f, --format string config & frontmatter format (default "toml") -h, --help help for site Options

PAGE RESOURCES

SASS / SCSS

Options transpiler New in v0.80.0 The transpiler to use, valid values are libsass (default) and dartsass.Note that the Embedded Dart Sass project is still in beta (beta 5 at the time of writing). The release is scheduled for Q1 2021.

.GETPAGE | HUGO

.GetPage and Multilingual Sites . The previous examples have used the full content filename to lookup the post. Depending on how you have organized your content (whether you have the language code in the file name or not, e.g. my-post.en.md), you may want to do the lookup without extension.This will get you the current language’s version

of the page:

COMPLETE LIST

Okayish Blog Hugo Theme. casper3. Ticky Tacky Dark

EDUCENTER HUGO

DEVELOPER TOOLS

One of Hugo’s greatest strengths is its passionate—and always evolving—developer community. With the exception of the highlight shortcode mentioned in Syntax Highlighting, the tools and other projects featured in this section are offerings from both commercial services and open-source projects, many of which are developed by Hugo developers just like you.

HUGO NEW SITE

hugo new site Create a new site (skeleton) Synopsis Create a new site in the provided directory. The new site will have the correct structure, but no content or theme yet. Use hugo new to create new content. hugo new site Options --force init inside non-empty directory -f, --format string config & frontmatter format (default "toml") -h, --help help for site Options

HUGO DEPLOY

You can use the “hugo deploy” command to upload your site directly to a Google Cloud Storage (GCS) bucket, an AWS S3 bucket, and/or an Azure Storage container.

PAGE RESOURCES

Page resources are only accessible from page bundles, those directories with index.md or _index.md files at their root. Page resources are only available to the page with which they are bundled. In this example, first-post is a page bundle with access to 10 page resources including audio, data, documents, images, and video. Although second-post is also a page bundle, it has no page resources

CONFIGURE MARKUP

See each section below for details. Goldmark . Goldmark is from Hugo 0.60 the default library used for Markdown. It’s fast, it’s CommonMark compliant and it’s very flexible. Note that the feature set of Goldmark vs Blackfriday isn’t the same; you gain a lot but also lose some, but we will work to bridge any gap in the upcoming

Hugo versions.

.GETPAGE | HUGO

.GetPage and Multilingual Sites . The previous examples have used the full content filename to lookup the post. Depending on how you have organized your content (whether you have the language code in the file name or not, e.g. my-post.en.md), you may want to do the lookup without extension.This will get you the current language’s version

of the page:

.FORMAT | HUGO

Syntax.Format FORMAT.Format will format date values defined in your front matter and can be used as a property on the following page variables:.PublishDate.Date.Lastmod; Assuming a key-value of date: 2017-03-03 in a content file’s front matter, your can run the date through .Format followed by a layout string for your desired output at

build time:

HOST ON GITLAB

GitLab makes it incredibly easy to build, deploy, and host your Hugo website via their free GitLab Pages service, which provides native support for Hugo, as well as numerous other static site generators.. Assumptions . Working familiarity with Git for version control; Completion of the Hugo Quick Start; A GitLab account; A Hugo website on your local machine that you are ready to publish HUGO PAPER | HUGO THEMES For more information read the official guide of Hugo.. Dark Mode . It’s automatic, according to your system settings, or the natural time of day and night. Pitiless Ads

INFINITY HUGO

Infinity is a responsive, modern and clean free construction/coming soon HTML template powered by Bootstrap4. This minimal template is packed with a countdown timer, contact form, about section where you can write a little bit about yourself and also feature section. THE WORLD’S FASTEST FRAMEWORK FOR BUILDING WEBSITES May 2, 2021 This version fixes an issue introduced in 0.83.0. May 1, 2021 WebP image encoding support, some important i18n fixes, and more. April 20, 2021 This version fixes a bug introduced in 0.82.0. March 21, 2021 Mostly bug fixes, but

GET STARTED

Get Started. If this is your first time using Hugo and you’ve already installed Hugo on your machine, we recommend the quick start. You can also use external learning resources to learn Hugo.

HUGO NEW | HUGO

hugo new Create new content for your site Synopsis Create a new content file and automatically set the date and title. It will guess which kind of file to create based on the path provided. You can also specify the kind with -k KIND. If archetypes are provided in your theme or site, they will be used. Ensure you run this within the root directory of your site.

PAGE RESOURCES

SHORTCODES | HUGO

A shortcode is a simple snippet inside a content file that Hugo will render using a predefined template. Note that shortcodes will not work in template files. If you need the type of drop-in functionality that shortcodes provide but in a template, you most likely want a partial template instead. In addition to cleaner Markdown, shortcodes can

COMPLETE LIST

Somrat Strange Case Travelify mini Bodhi Theme Blackburn casper3 Soho Hugo Primer Academia Hugo Hugo Novela Persian Hugo Vanilla Bootstrap Sicily Sustain Paperesque Flex BP CV Accessible Minimalism Blogpaper aether Northendlab Hugo Simple Resume Hargo Hugo E Commerce Theme Codex Lanyon Navigator Hugo Grayscale Ink Even bento Axiom SK2 SK1

SASS / SCSS

Options transpiler New in v0.80.0 The transpiler to use, valid values are libsass (default) and dartsass.Note that the Embedded Dart Sass project is still in beta (beta 5 at the time of writing). The release is scheduled for Q1 2021.

EDUCENTER HUGO

HUGO PAPER | HUGO THEMES For more information read the official guide of Hugo.. Dark Mode . It’s automatic, according to your system settings, or the natural time of day and night. Pitiless Ads

TWENTY TWENTY HUGO

THE WORLD’S FASTEST FRAMEWORK FOR BUILDING WEBSITES May 2, 2021 This version fixes an issue introduced in 0.83.0. May 1, 2021 WebP image encoding support, some important i18n fixes, and more. April 20, 2021 This version fixes a bug introduced in 0.82.0. March 21, 2021 Mostly bug fixes, but

GET STARTED

Get Started. If this is your first time using Hugo and you’ve already installed Hugo on your machine, we recommend the quick start. You can also use external learning resources to learn Hugo.

HUGO NEW | HUGO

hugo new Create new content for your site Synopsis Create a new content file and automatically set the date and title. It will guess which kind of file to create based on the path provided. You can also specify the kind with -k KIND. If archetypes are provided in your theme or site, they will be used. Ensure you run this within the root directory of your site.

PAGE RESOURCES

SHORTCODES | HUGO

A shortcode is a simple snippet inside a content file that Hugo will render using a predefined template. Note that shortcodes will not work in template files. If you need the type of drop-in functionality that shortcodes provide but in a template, you most likely want a partial template instead. In addition to cleaner Markdown, shortcodes can

COMPLETE LIST

Somrat Strange Case Travelify mini Bodhi Theme Blackburn casper3 Soho Hugo Primer Academia Hugo Hugo Novela Persian Hugo Vanilla Bootstrap Sicily Sustain Paperesque Flex BP CV Accessible Minimalism Blogpaper aether Northendlab Hugo Simple Resume Hargo Hugo E Commerce Theme Codex Lanyon Navigator Hugo Grayscale Ink Even bento Axiom SK2 SK1

SASS / SCSS

Options transpiler New in v0.80.0 The transpiler to use, valid values are libsass (default) and dartsass.Note that the Embedded Dart Sass project is still in beta (beta 5 at the time of writing). The release is scheduled for Q1 2021.

EDUCENTER HUGO

HUGO PAPER | HUGO THEMES For more information read the official guide of Hugo.. Dark Mode . It’s automatic, according to your system settings, or the natural time of day and night. Pitiless Ads

TWENTY TWENTY HUGO

SITE VARIABLES

Site Variables. Many, but not all, site-wide variables are defined in your site’s configuration. However, Hugo provides a number of built-in variables for convenient access to global values in your templates. The following is a list of site-level (aka “global”) variables. Many of these variables are defined in your site’s

configuration

INSTALL HUGO

You’ll need a place to store the Hugo executable, your content, and the generated Hugo website: Open Windows Explorer. Create a new folder: C:\Hugo, assuming you want Hugo on your C drive, although this can go anywhere. Create a subfolder in the Hugo folder: C:\Hugo\bin. Create another subfolder in Hugo: C:\Hugo\Sites.

HUGO MODULES

Hugo Modules are the core building blocks in Hugo. A module can be your main project or a smaller module providing one or more of the 7 component types defined in Hugo: static, content, layouts, data, assets, i18n, and archetypes.. You can combine modules in any combination you like, and even mount directories from non-Hugo projects, forming a big, virtual union file system.

URL MANAGEMENT

Permalinks . The default Hugo target directory for your built website is public/.However, you can change this value by specifying a different publishDir in your site configuration.The directories created at build time for a section reflect the position of the content’s directory within the content folder and namespace matching its layout within the contentdir hierarchy.

HUGO NEW | HUGO

hugo new Create new content for your site Synopsis Create a new content file and automatically set the date and title. It will guess which kind of file to create based on the path provided. You can also specify the kind with -k KIND. If archetypes are provided in your theme or site, they will be used. Ensure you run this within the root directory of your site.

SHOWCASE | HUGO

The world’s fastest framework for building websites. The Showcase articles are copyrighted by their respective content authors.

PAGE RESOURCES

Page resources are only accessible from page bundles, those directories with index.md or _index.md files at their root. Page resources are only available to the page with which they are bundled. In this example, first-post is a page bundle with access to 10 page resources including audio, data, documents, images, and video. Although second-post is also a page bundle, it has no page resources

GIT INFO VARIABLES

.GitInfo Prerequisites . The Hugo site must be in a Git-enabled directory. The Git executable must be installed and in your system PATH.; The .GitInfo feature must be enabled in your Hugo project by passing --enableGitInfo flag on the command line or by setting enableGitInfo to true in your site’s configuration file.; The .GitInfo Object . The GitInfo object contains the following fields:

PLAINIFY - GO HUGO

Strips any HTML and returns the plain text version of the provided

string.

INFINITY HUGO

Infinity Hugo. Infinity is a responsive, modern and clean free construction/coming soon HTML template powered by Bootstrap4. This minimal template is packed with a countdown timer, contact form, about section where you can write a little bit about yourself and also feature section. Infinity based on Bootstrap 4 and offers Amazing

design layout.

HUGO

* News

* Docs

* Themes

* Showcase

* Community

* GitHub

Search

THE WORLD’S FASTEST FRAMEWORK FOR BUILDING WEBSITES Hugo is one of the most popular open-source static site generators. With its amazing speed and flexibility, Hugo makes building websites

fun again.

Quick Start

May 6, 2020 Hugo 0.70.0 adds a new pipe function that uses Babel to transpile JavaScript. April 24, 2020 This version fixes a couple of bugs introduced in 0.69.0. April 22, 2020 This version fixes a couple of bugs introduced in 0.69.0. April 10, 2020 Hugo 0.69.0 allows you to delay resource processing to after the build, the prime use case being…

BLISTERING SPEED

What's modern about waiting for your site to build? Hugo is the fastest tool of its kind. At <1 ms per page, the average site builds in less than a second. ROBUST CONTENT MANAGEMENT Flexibility rules. Hugo is a content strategist's dream. Hugo supports unlimited content types, taxonomies, menus, dynamic API-driven content, and more, all without plugins.

SHORTCODES

Hugo's shortcodes are Markdown's hidden superpower. We love the beautiful simplicity of markdown’s syntax, but there are times when we want more flexibility. Hugo shortcodes allow for both beauty and flexibility.

BUILT-IN TEMPLATES

Hugo has common patterns to get your work done quickly. Hugo ships with pre-made templates to make quick work of SEO, commenting, analytics and other functions. One line of code, and

you're done.

MULTILINGUAL AND I18N

Polyglot baked in.

Hugo provides full i18n support for multi-language sites with the same straightforward development experience Hugo users love in single-language sites.

CUSTOM OUTPUTS

HTML not enough?

Hugo allows you to output your content in multiple formats, including JSON or AMP, and makes it easy to create your own.

HUGO SPONSORS

300+ THEMES

Hugo provides a robust theming system that is easy to implement but capable of producing even the most complicated websites. Check out the Hugo themes.

CAPABLE TEMPLATING

Hugo's Go-based templating provides just the right amount of logic to build anything from the simple to complex.

Get Started.

SHOWCASE

Digital.gov →

KeyCDN →

Forestry.io →

Over →

Linode Docs →

Hapticmedia Blog → Flesland Flis AS → Hartwell Insurance →

Cocoon & Cosy →

Pace Revenue Management →

Let’s Encrypt →

See All

INSTALL IN SECONDS, BUILD IN MILLISECONDS. Hugo works on macOS, Windows, Linux, FreeBSD, and others. Host on any server or your favorite CDN.

Mac OS

$ brew install hugo

Windows

$ choco install hugo -confirm

Linux

$ snap install hugo

See the Getting Started Guide for other methods. SEE WHAT OTHERS ARE SAYING ABOUT HUGO… > Working with @GoHugoIO is such a joy. Having worked with #Jekyll in > the past, the near instant preview is a big win! Did not expect this > to make such a huge difference. > ─ Heinrich Hartmann (@heinrichhartman) November 12, 2019

>

> Can't overstate how much I enjoy @GoHugoIO > . My site is relatively small, but *18 > ms* to build the whole thing made template development and proofing

> a breeze.

> ─ Joshua Steven‏‏ (@jscarto) September 12, 2018

>

> Hugo is really, really incredible... Now does resizing/resampling of > images as well! Crazy that something so fast can be a static site > generator... Amazing open-source project. > ─ Jens Munch (@jensamunch) January 3, 2018

>

> I fear @GoHugoIO  v0.22 might be so > fast it creates a code vortex that time-warps me back to a time I > used Wordpress. #gasp > ─ STOQE (@STOQE) June 12, 2017

>

WE WELCOME ALL CONTRIBUTIONS * Fork the repo and work on an issue

* Design a theme

Hugo is open-source and completely free. Our hundreds of contributors make Hugo great. MORE WAYS TO CONTRIBUTE * Help improve the docs * Help others in the forums

By the Hugo Authors

* File an Issue

* Get Help

* Discuss Source Code

* @GoHugoIO

* @spf13

* @bepsays

HUGO SPONSORS

The Hugo logos are copyright © Steve Francia 2013–2020. The Hugo Gopher is based on an original work by Renée French.

* News

* Docs

* Themes

* Showcase

* Community

* GitHub

* About Hugo

* Getting Started

* Hugo Modules

* Content Management

* Templates

* Functions

* Variables

* Hugo Pipes

* CLI

* Troubleshooting

* Tools

* Hosting & Deployment

* Contribute

* Maintenance

Menu Docs Menu