hugo/docs/content/themes/usage.md

---
lastmod: 2015-01-27
date: 2014-05-12T10:09:27Z
menu:
  main:
    parent: themes
next: /themes/customizing
prev: /themes/installing
title: Using a Theme
weight: 30
---

Please make certain you have installed the themes you want to use in the
`/themes` directory.

To use a theme for a site, execute Hugo with the following parameter:

    hugo -t ThemeName

or add this line to your site configuration:

    theme:                      "ThemeName"

The *ThemeName* must match the name of the directory inside `/themes`.

Hugo will then apply the theme first, then apply anything that is in the local
directory. To learn more, go to [customizing themes](/themes/customizing/).
Converting front matter to YAML 2014-05-29 18:42:05 -04:00			`---`
docs: Add lastmod to content files Based on last commit in Git. 2016-01-06 17:45:19 -05:00			`lastmod: 2015-01-27`
Converting front matter to YAML 2014-05-29 18:42:05 -04:00			`date: 2014-05-12T10:09:27Z`
			`menu:`
			`main:`
			`parent: themes`
			`next: /themes/customizing`
			`prev: /themes/installing`
			`title: Using a Theme`
			`weight: 30`
			`---`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00
			`Please make certain you have installed the themes you want to use in the`
Docs: Minor copyediting/proofreading - Correct some typos - Add backticks and commas where necessary - Use fenced code blocks specifying "bash" as the language to avoid weird highlighting - Place commas outside of quotation marks surroundingn codes to avoid possible confusion - Suggest users to use the discussion forum rather than the mailing list 2014-12-04 11:26:12 -05:00			`/themes` directory.
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00
docs: Mention theme config option on Usage page 2016-08-31 05:38:21 -04:00			`To use a theme for a site, execute Hugo with the following parameter:`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00
			`hugo -t ThemeName`

docs: Mention theme config option on Usage page 2016-08-31 05:38:21 -04:00			`or add this line to your site configuration:`

			`theme: "ThemeName"`

Docs: Minor copyediting/proofreading - Correct some typos - Add backticks and commas where necessary - Use fenced code blocks specifying "bash" as the language to avoid weird highlighting - Place commas outside of quotation marks surroundingn codes to avoid possible confusion - Suggest users to use the discussion forum rather than the mailing list 2014-12-04 11:26:12 -05:00			The ThemeName must match the name of the directory inside `/themes`.
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00
			`Hugo will then apply the theme first, then apply anything that is in the local`
[Docs] Copyediting * Add meta author, description and generator tags * Add Hugo version beside the logo and in the footer * Suggest the user to run `go get -u -v` to update dependencies * Requires Go 1.3+ rather than Go 1.1+ * Improve rendering/formatting in some places * Add trailing slash to URLs where appropriate * GitHub redirects all http requests to https, update accordingly 2015-01-27 21:17:09 -05:00			`directory. To learn more, go to [customizing themes](/themes/customizing/).`