Version 5.0 (February 2021)

Introducing Wowchemy

We are thrilled to unveil the new Wowchemy branding and restructuring of the various Hugo Academic related projects to unite the ecosystem in one place on our open source mission to empower creators and educators.

A BIG thanks to all the sponsors and contributors for helping to make this possible!

👉 Learn about the exciting journey in our blog post

We invite you to browse the united Wowchemy open source ecosystem on GitHub, star your favourite repositories to show your support for open source ⭐️, and connect with the community 👥:

🙌 A big shout out to Christian and Rodri for kindly volunteering to help the community and moderate discussions.

Starter templates

Based on your feedback, there is now a choice of templates so you can more easily create other kinds of site in addition to the popular academic resume template, whilst still utilizing the same core features and documentation. Learn more in our blog post.

Based on your feedback, there is now a [choice of templates](/templates).
Based on your feedback, there is now a choice of templates.

What’s new?

Welcome to the ⭐ EPIC ⭐ v5 release of Wowchemy.

So what’s new in each iteration and how can you update?

How do I upgrade my site?

Convert your site to use Hugo Modules

Wowchemy v5 uses Hugo’s new Module system for themes and plugins.

When migrating from v4 to v5, the main change is to adopt Hugo’s Module system.

Learn how to migrate your site to the new Hugo Module system

Site Changes

Refer to the update guide in conjunction with the changes mentioned in each of the separate beta 0… release notes.

Apply any relevant site changes consecutively.

For example, if you are upgrading from v4 to the latest v5 Beta, apply Beta 0 changes, then Beta 1 changes, and so on.

Whereas, if you wish to upgrade from v5 Beta 1 to Beta 2, just apply any relevant changes from the Beta 2 page.

Note that if you are running the main (cutting edge) version rather than an official tagged release, some of these changes may already have been applied.

Alternatively, you may wish to start fresh with one of the new templates and migrate your domain and content across.


  1. Check out the solutions to common issues
  2. Compare your site structure, config, and front matter with those in the templates
  3. If the issue is not resolved, feel free to post on our GitHub Discussions Forum with a link to your GitHub repository and a description of the issue

Alternatively, consider starting fresh with one of the new templates and migrating your domain and content across.

Thank you

Last but certainly not least, a big Thank You to all the folks that helped to make Wowchemy even better.

Has Wowchemy helped you? Please consider supporting this open source initiative ❤️

As always, we welcome your feedback.

Ask a question