By default, the static/ directory in the site project is used for
Hugo can be configured to look into a different directory, or even
multiple directories for such static files by configuring the
staticDir parameter in the site config. All the files in all the
static directories will form a union filesystem.
This union filesystem will be served from your site root. So a file
<SITE PROJECT>/static/me.png will be accessible as
Here’s an example of setting staticDir and staticDir2 for a
The English site will get its static files as a union of “static1”,
“static2” and “static_en”. On file duplicates, the right-most
version will win.
The Norwegian site will get its static files as a union of
“staticDir_override” and “static_no”.
The 2 (can be a number between 0 and 10) in staticDir2 is
added to tell Hugo that you want to add this directory to the
global set of static directories defined using staticDir. Using
staticDir on the language level would replace the global value (as
can be seen in the Norwegian site case).
The example above is a multihost setup. In a regular setup, all
the static directories will be available to all sites.