{"record":{"id":"ee5924886fbc795e","repo":"gohugoio/hugo","slug":"this-feature-is-not-available-in-your-current-hugo","errorCode":null,"errorMessage":"this feature is not available in your current Hugo version, see https://goo.gl/YMrWcn for more information","messagePattern":"this feature is not available in your current Hugo version, see https://goo\\.gl/YMrWcn for more information","errorType":"exception","errorClass":"FeatureNotAvailableError","httpStatus":null,"severity":"error","filePath":"common/herrors/errors.go","lineNumber":87,"sourceCode":"\nfunc (e *errMessage) Error() string {\n\treturn e.msg\n}\n\nfunc (e *errMessage) Unwrap() error {\n\treturn e.err\n}\n\n// IsFeatureNotAvailableError returns true if the given error is or contains a FeatureNotAvailableError.\nfunc IsFeatureNotAvailableError(err error) bool {\n\treturn errors.Is(err, &FeatureNotAvailableError{})\n}\n\n// ErrFeatureNotAvailable denotes that a feature is unavailable.\n//\n// We will, at least to begin with, make some Hugo features (SCSS with libsass) optional,\n// and this error is used to signal those situations.\nvar ErrFeatureNotAvailable = &FeatureNotAvailableError{Cause: errors.New(\"this feature is not available in your current Hugo version, see https://goo.gl/YMrWcn for more information\")}\n\n// FeatureNotAvailableError is an error type used to signal that a feature is not available.\ntype FeatureNotAvailableError struct {\n\tCause error\n}\n\nfunc (e *FeatureNotAvailableError) Unwrap() error {\n\treturn e.Cause\n}\n\nfunc (e *FeatureNotAvailableError) Error() string {\n\treturn e.Cause.Error()\n}\n\nfunc (e *FeatureNotAvailableError) Is(target error) bool {\n\t_, ok := target.(*FeatureNotAvailableError)\n\treturn ok\n}","sourceCodeStart":69,"sourceCodeEnd":105,"githubUrl":"https://github.com/gohugoio/hugo/blob/52c9bd7908b4d02d4d0ff8f82a888834d6ee10d2/common/herrors/errors.go#L69-L105","documentation":"ErrFeatureNotAvailable is a sentinel FeatureNotAvailableError used for optional Hugo features compiled out of the binary (e.g. libsass-based SCSS). When a template or resource path invokes such a feature in a binary that was not built with it, this error is returned.","triggerScenarios":"Calling resources.ToCSS with the libsass compiler (or a similar optional feature) in a Hugo binary built without the corresponding build tag or library.","commonSituations":"Using a non-extended Hugo distribution; SCSS via libsass when only the built-in transpiler is available; a feature flagged off in the installed version.","solutions":["Install the Hugo extended build (or the build that includes the needed feature)","Switch to the supported alternative (e.g. Dart Sass transpiler options)","Build Hugo from source with the required build tag"],"exampleFix":"# before\nhugo  # missing libsass\n# after (install hugo extended)\n# download hugo_extended_<version>.tar.gz and retry","handlingStrategy":"try-catch","validationCode":null,"typeGuard":"func isFeatureNotAvailable(err error) bool {\n    return herrors.IsFeatureNotAvailableError(err)\n}","tryCatchPattern":"if _, err := feature.Call(...); err != nil {\n    if herrors.IsFeatureNotAvailableError(err) {\n        // prompt user to install the extended build or use an alternative\n    } else {\n        return err\n    }\n}","preventionTips":["Install hugo_extended when using libsass-based SCSS","Detect FeatureNotAvailableError and surface an actionable message to users"],"tags":["features","build-tags","scss","go","hugo"],"backgroundTag":null,"analyzedSha":"52c9bd7908b4d02d4d0ff8f82a888834d6ee10d2","analyzedAt":"2026-08-09T21:49:36.660Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}