Installing the Ananke Theme for Hugo #

There are two primary ways to install Ananke:

  1. Hugo Module — Uses Hugo’s built-in Go module system to fetch and manage the theme as a package.
  2. Git Submodule — Links the theme repository as a submodule inside your Hugo project.

If you’re following the Hugo Quickstart guide, you’ll notice that it currently recommends installing the Ananke theme as a Git submodule. While this is a valid approach, Hugo also offers a more powerful alternative: Hugo Modules, which leverage Go’s module system for better dependency management.

We prefer the Hugo Module approach, as it provides a more flexible and future-proof way to manage themes.

[!NOTE] Already using Ananke from the old theNewDynamic repository? See Migration from theNewDynamic to update your references to github.com/gohugo-ananke/ananke.

Comparison: Hugo Module vs. Git Submodule #

MethodProsConsSample Repo
Hugo Module (Preferred)Easier version management, automatic updates, better integrationRequires Go installed and initial setupSample Repo
Git SubmoduleSimple if you are used to working with GitRequires manual updates, can be tricky with Git workflowsSample Repo
Introduction

Installation as a Hugo Module (recommended)

Hugo Module based installation for the Ananke theme for Hugo.

Methods #

Requirements #

  1. Install Hugo (extended or extended/deploy edition, 0.128.0 or later)
  2. Install Git
  3. Install Golang

Installation #

To install or create a Hugo website from scratch with the Ananke theme using the Hugo Module method, follow these steps:

read more
Introduction

Installation as Git Submodule

Git Submodule based installation for the Ananke theme for Hugo.

Methods #

Requirements #

  1. Install Hugo (extended or extended/deploy edition, 0.128.0 or later)
  2. Install Git

Installation #

To install or create a Hugo website from scratch with the Ananke theme using the submodule method, follow these steps:

read more
Introduction

Upgrading from theNewDynamic to gohugo-ananke

Ananke moved to its own organisation in April 2026. The repository changed from: github.com/theNewDynamic/gohugo-theme-ananke to github.com/gohugo-ananke/ananke.

Both URLs still resolve for now, so existing sites will keep building, but you should update your references so future updates come from the new location.

What changed #

  • Organisation and repository name changed as shown above.
  • Module path changed from github.com/theNewDynamic/gohugo-theme-ananke/v2 to github.com/gohugo-ananke/ananke/v2. The /v2 suffix is unchanged and still required for the latest theme on the v2 branch.
  • Installation methods are unchanged. If you are installing fresh rather than migrating, follow Install as Hugo Module or Install as Git Submodule instead of this page.

Migrate a Hugo Module install #

Search your site configuration for the old module path and replace every instance of github.com/theNewDynamic/gohugo-theme-ananke/v2 with github.com/gohugo-ananke/ananke/v2.

read more