you need to a newer version of Go to use it. See https://go

Error message

 you need to a newer version of Go to use it. See https://golang.org/dl/ : %w

What it means

Returned by wrapModuleNotFound (modules/collect.go:899) when c.goBinaryStatus == goBinaryStatusTooOld. This status is set in client.go:816 when the go command fails with stderr containing 'flag provided but not defined' — i.e. Hugo passes flags the installed Go version does not understand. The user is told to upgrade Go.

Source

Thrown at modules/collect.go:899

	return out, nil
}

func (c *collector) wrapModuleNotFound(err error) error {
	if c.Client.ccfg.IgnoreModuleDoesNotExist {
		return nil
	}
	err = fmt.Errorf(err.Error()+": %w", ErrNotExist)
	if c.GoModulesFilename == "" {
		return err
	}

	baseMsg := "we found a go.mod file in your project, but"

	switch c.goBinaryStatus {
	case goBinaryStatusNotFound:
		return fmt.Errorf(baseMsg+" you need to install Go to use it. See https://golang.org/dl/ : %q", err)
	case goBinaryStatusTooOld:
		return fmt.Errorf(baseMsg+" you need to a newer version of Go to use it. See https://golang.org/dl/ : %w", err)
	}

	return err
}

type vendoredModule struct {
	Owner   Module
	Dir     string
	Version string
}

func createProjectModule(gomod *goModule, workingDir string, conf Config) *moduleAdapter {
	// Create a pseudo module for the main project.
	var path string
	if gomod == nil {
		path = "project"
	}

View on GitHub (pinned to 52c9bd7908)

Solutions

Upgrade Go to a recent release from https://go.dev/dl/ and confirm with 'go version'.
Remove stale Go installs from PATH / version managers that shadow the new one.
Run 'hugo mod tidy' after upgrading to rebuild the module graph.

Example fix

// before: go 1.16 installed, Hugo needs newer flags -> error
// after
go version   // 1.22+
hugo

Defensive patterns

Strategy: validation

Validate before calling

// preflight: ensure the installed Go meets the minimum version
if out, err := exec.Command("go", "version").Output(); err == nil {
    if !meetsMinimum(string(out), minGoVersion) {
        return fmt.Errorf("Go too old: need >= %s", minGoVersion)
    }
}

Prevention

Upgrade Go alongside Hugo upgrades.
Remove stale Go installs shadowing the new one on PATH.
Document the required Go version in your build setup.

When it happens

Trigger: A go.mod is present and the installed Go is older than what Hugo's module commands require; the go binary runs but rejects a flag Hugo relies on.

Common situations: Long-running servers with an ancient Go (pre-1.16 module era); package managers shipping outdated Go; mismatch between Hugo version and the minimum Go version Hugo was built against.

Related errors

AI-assisted analysis of gohugoio/hugo@52c9bd7908 (2026-08-09). Data as JSON: /api/errors/31d453466c205e11. Report an issue: GitHub.