USWDS Hugo theme

A Hugo theme made with United States Web Design System.

Minimum Hugo version

Hugo extended version 0.55.5 or higher is required. View the Hugo releases and download the binary for your OS.


From the root of your site:

git submodule add themes/uswds-hugo-theme


From the root of your site:

git submodule update --remote --merge

Run example site

From the root of themes/uswds-hugo-theme/exampleSite:

hugo server --themesDir ../..


Copy the config.yaml from the exampleSite, then edit as desired.



{{< accordion >}}

{{< accordion-item heading="2" summary="First Amendment" >}}
Congress shall make no law respecting an establishment of religion, or prohibiting the free exercise thereof; or abridging the freedom of speech, or of the press; or the right of the people peaceably to assemble, and to petition the Government for a redress of grievances.
{{< /accordion-item >}}

{{< accordion-item heading="2" summary="Second Amendment" >}}
A well regulated Militia, being necessary to the security of a free State, the right of the people to keep and bear Arms, shall not be infringed.
{{< /accordion-item >}}

{{< accordion-item heading="2" summary="Some summary" >}}
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc justo ligula, laoreet quis leo sit amet, ornare luctus orci. Maecenas eu mollis felis, quis blandit justo. 

- This is a list item
- Another list item
{{< /accordion-item >}}

{{< /accordion >}}


The author param is optional.

{{% blockquote author="Carl Jung" %}}
Even a happy life cannot be without a measure of darkness, and the word happy would lose its meaning if it were not balanced by sadness. It is far better to take things as they come along with patience and equanimity.
{{% /blockquote %}}


Only works with page bundle images.

{{< figure
alt="The Sun" 
caption="The Sun is the star at the center of the Solar System. It is a nearly perfect sphere of hot plasma, with internal convective motion that generates a magnetic field via a dynamo process. It is by far the most important source of energy for life on Earth. [Credits](" 
options="800x" >}}