Skip to main content
Photo by Ferenc Almasi via Unsplash

Converting frontmatter in GoHugo

Some days ago I realised, that I keep all my configurations for GoHugo in the TOML format, while using YAML for the frontmatters in my content folder. That did not seem right ;) so I changed those too to TOML.

Hugo has an easy command convert, to transform frontmatter from one type to another.

1hugo convert toJSON
2hugo convert toTOML
3hugo convert toYAML

If Hugo detects any issues, it will decide to NOT transform the frontmatter. In that case you can force it to transform by adding the --unsafe option to the call:

1hugo convert toJSON --unsafe
2hugo convert toTOML --unsafe
3hugo convert toYAML --unsafe

After running this command your frontmatter will be in the new format. The only problem that I experienced was, that after converting from YAML to TOML all frontmatter items were in alphabetical order, which is nice, but might confuse us later on. I like my frontmatter sorted by topics.

Don’t forget to change your archetypes too (there is no command for this, so you need to do it manually), so all future content too is in your new preferred format.

Back to top
Back Forward