{"record":{"id":"b0400317be43c923","repo":"gohugoio/hugo","slug":"failed-to-resolve-media-type-for-q","errorCode":null,"errorMessage":"failed to resolve media type for %q","messagePattern":"failed to resolve media type for %q","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"resources/page/pagemeta/page_frontmatter.go","lineNumber":430,"sourceCode":"\t\t\treturn fmt.Errorf(\"failed to resolve media type for suffix %q\", ext)\n\t\t}\n\t}\n\n\tvar s string\n\tif p.ContentMediaType.IsZero() {\n\t\tif p.Content.MediaType != \"\" {\n\t\t\ts = p.Content.MediaType\n\t\t\tp.ContentMediaType, _ = mediaTypes.GetByType(s)\n\t\t}\n\n\t\tif p.ContentMediaType.IsZero() && p.Content.Markup != \"\" {\n\t\t\ts = p.Content.Markup\n\t\t\tp.ContentMediaType = MarkupToMediaType(s, mediaTypes)\n\t\t}\n\t}\n\n\tif p.ContentMediaType.IsZero() {\n\t\treturn fmt.Errorf(\"failed to resolve media type for %q\", s)\n\t}\n\n\tif p.Content.Markup == \"\" {\n\t\tp.Content.Markup = p.ContentMediaType.SubType\n\t}\n\treturn nil\n}\n\n// Compile sets up the page configuration after all fields have been set.\nfunc (p *PageConfigLate) Compile(e *PageConfigEarly, logger loggers.Logger, outputFormats output.Formats) error {\n\tif e.IsFromContentAdapter {\n\t\tif err := mapstructure.WeakDecode(p.ContentAdapterData, p); err != nil {\n\t\t\terr = fmt.Errorf(\"failed to decode page map: %w\", err)\n\t\t\treturn err\n\t\t}\n\t}\n\n\tif p.Params == nil {","sourceCodeStart":412,"sourceCodeEnd":448,"githubUrl":"https://github.com/gohugoio/hugo/blob/52c9bd7908b4d02d4d0ff8f82a888834d6ee10d2/resources/page/pagemeta/page_frontmatter.go#L412-L448","documentation":"Thrown by resolveContentType as the final fallback after it tried both the explicit Content.MediaType (via mediaTypes.GetByType) and the Content.Markup string (via MarkupToMediaType) and the resolved ContentMediaType is still zero. The reported string is the markup or mediaType value that could not be resolved.","triggerScenarios":"Front matter or page config sets 'markup' or 'mediaType' to a value that does not map to any registered media type, e.g. 'markup: myownformat' or 'mediaType: application/x-nonexistent'.","commonSituations":"Typos in the markup/mediaType front matter value, referencing a media type that was not added under [mediaTypes], or assuming a format is built-in when it requires a content adapter or config.","solutions":["Correct the markup/mediaType value to one Hugo knows (md, html, org, rst, asciidoc, pandoc, etc.).","Register the custom media type under [mediaTypes] and (if needed) a content adapter for it.","Leave markup empty so Hugo infers it from the file extension."],"exampleFix":"# before\n---\nmarkup: mardown\n---\n# after\n---\nmarkup: md\n---","handlingStrategy":"validation","validationCode":"s := strings.ToLower(markupOrMediaType)\nif _, found := mediaTypes.GetByType(s); !found {\n    if mt := pagemeta.MarkupToMediaType(s, mediaTypes); mt.IsZero() {\n        return fmt.Errorf(\"unknown markup/mediaType %q\", s)\n    }\n}","typeGuard":null,"tryCatchPattern":"if err := pcfg.CompileEarly(pi, cascades, conf, fim, base, false); err != nil {\n    return fmt.Errorf(\"resolve media type: %w\", err)\n}","preventionTips":["Use recognized markup identifiers (md, html, org, rst, asciidoc).","Register custom media types before referencing them in markup/mediaType.","Leave markup unset to rely on extension inference."],"tags":["hugo","media-type","markup","front-matter","configuration"],"backgroundTag":null,"analyzedSha":"52c9bd7908b4d02d4d0ff8f82a888834d6ee10d2","analyzedAt":"2026-08-09T21:49:36.660Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}