{"record":{"id":"4ea1f885b4103055","repo":"OpenRefine/OpenRefine","slug":"unsupported-manifest-version-version","errorCode":null,"errorMessage":"unsupported manifest version: ${version}","messagePattern":"unsupported manifest version: (.+?)","errorType":"validation","errorClass":"org.openrefine.wikibase.manifests.ManifestException","httpStatus":null,"severity":"error","filePath":"extensions/wikibase/src/org/openrefine/wikibase/manifests/ManifestParser.java","lineNumber":49,"sourceCode":"        if (StringUtils.isBlank(version)) {\n            throw new ManifestException(\"invalid manifest format, version is missing\");\n        }\n        if (!version.matches(\"[0-9]+\\\\.[0-9]+\")) {\n            throw new ManifestException(\"invalid version: \" + version);\n        }\n\n        String majorVersion = version.split(\"\\\\.\")[0];\n        // support only v1.x for now\n        if (\"1\".equals(majorVersion)) {\n            return new ManifestV1(manifestJson);\n        } else if (\"2\".equals(majorVersion)) {\n            try {\n                return new ManifestV2(manifestJson);\n            } catch (IOException e) {\n                throw new ManifestException(\"invalid manifest format: \" + e.getMessage());\n            }\n        } else {\n            throw new ManifestException(\"unsupported manifest version: \" + version);\n        }\n    }\n}\n","sourceCodeStart":31,"sourceCodeEnd":53,"githubUrl":"https://github.com/OpenRefine/OpenRefine/blob/a946177e049f3b0644261661db36cbb0c81ccf8a/extensions/wikibase/src/org/openrefine/wikibase/manifests/ManifestParser.java#L31-L53","documentation":"ManifestParser.parse only supports manifest major versions 1 and 2; any other major version throws this ManifestException. It signals that the manifest was authored for a newer (or bogus) manifest specification that this OpenRefine build cannot interpret.","triggerScenarios":"Parsing a manifest with version \"3.0\", \"0.1\", or any major version other than 1 or 2.","commonSituations":"Downloading a manifest written for a newer OpenRefine/Wikibase extension; using an OpenRefine release that predates the manifest version the target Wikibase publishes; typos in the version field.","solutions":["Upgrade OpenRefine (and the Wikibase extension) to a release supporting the manifest's major version.","Downgrade the manifest to version 2.x if the target Wikibase exposes one, adapting fields per the v2 spec.","Fix a typo in the manifest version field (e.g. \"3.0\" meant to be \"2.0\").","Check OpenRefine's release notes for the maximum supported manifest version."],"exampleFix":"// before (manifest)\n\"version\": \"3.0\"\n\n// after (supported by this parser)\n\"version\": \"2.1\"","handlingStrategy":"validation","validationCode":"String version = manifestNode.path(\"version\").textValue();\nString major = version == null ? null : version.split(\"\\\\.\")[0];\nboolean supported = \"1\".equals(major) || \"2\".equals(major);","typeGuard":null,"tryCatchPattern":"try {\n    Manifest m = ManifestParser.parse(manifestNode);\n} catch (ManifestException e) {\n    if (e.getMessage().startsWith(\"unsupported manifest version\")) { /* upgrade OpenRefine or downgrade manifest */ }\n    else throw e;\n}","preventionTips":["Check your OpenRefine version's supported manifest major versions (1.x, 2.x) before using a manifest","Upgrade OpenRefine when targeting Wikibases publishing newer manifests","Avoid typos in the version field by copying from official sources"],"tags":["wikibase","manifest","version","compatibility"],"backgroundTag":"unsupported-enum-value","analyzedSha":"a946177e049f3b0644261661db36cbb0c81ccf8a","analyzedAt":"2026-09-08T10:21:27.735Z","contentChangedAt":"2026-09-08T10:21:27.735Z","schemaVersion":2},"datasetVersion":"2026-09-17T15:17:12.973Z"}