{"record":{"id":"edf5318a5c0b3f61","repo":"RocketChat/Rocket.Chat","slug":"marketplace-unsupported-version","errorCode":null,"errorMessage":"Marketplace_Unsupported_Version","messagePattern":"Marketplace_Unsupported_Version","errorType":"exception","errorClass":"MarketplaceUnsupportedVersionError","httpStatus":400,"severity":"error","filePath":"apps/meteor/ee/server/apps/marketplace/fetchMarketplaceApps.ts","lineNumber":182,"sourceCode":"\t\tif (error instanceof CloudOfflineLicenseError) {\n\t\t\tthrow error;\n\t\t}\n\t\tthrow new MarketplaceConnectionError('Marketplace_Bad_Marketplace_Connection');\n\t}\n\n\tif (request.status === 200) {\n\t\tconst response = await request.json();\n\t\tfetchMarketplaceAppsSchema.parse(response);\n\t\treturn response;\n\t}\n\n\tconst response = await request.json();\n\n\tApps.getRocketChatLogger().error({ msg: 'Error fetching marketplace apps', status: request.status, response });\n\n\t// TODO: Refactor cloud to return a proper error code on unsupported version\n\tif (request.status === 426 && 'errorMsg' in response && response.errorMsg === 'unsupported version') {\n\t\tthrow new MarketplaceUnsupportedVersionError();\n\t}\n\n\tif (request.status === 400 && response.code === 200) {\n\t\tthrow new MarketplaceAppsError('Marketplace_Invalid_Apps_Engine_Version');\n\t}\n\n\tconst INTERNAL_MARKETPLACE_ERROR_CODES = [266, 256, 166, 221, 257, 320];\n\n\tif (request.status === 500 && INTERNAL_MARKETPLACE_ERROR_CODES.includes(response.code)) {\n\t\tthrow new MarketplaceAppsError('Marketplace_Internal_Error');\n\t}\n\n\tthrow new MarketplaceAppsError('Marketplace_Failed_To_Fetch_Apps');\n}\n","sourceCodeStart":164,"sourceCodeEnd":197,"githubUrl":"https://github.com/RocketChat/Rocket.Chat/blob/b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0/apps/meteor/ee/server/apps/marketplace/fetchMarketplaceApps.ts#L164-L197","documentation":"MarketplaceUnsupportedVersionError (message 'Marketplace_Unsupported_Version') is thrown when fetching the marketplace apps list and the cloud responds HTTP 426 (Upgrade Required) with errorMsg 'unsupported version'. The cloud is stating this server's version is too old (or too new/unknown) for the current marketplace API, so the app list cannot be served. A code TODO notes the cloud should return a proper error code instead of this string match.","triggerScenarios":"Any marketplace apps listing (browse/EXPLORE page) from a server whose Rocket.Chat version the cloud no longer supports; typically very old LTS branches after cloud deprecation, or pre-release builds the cloud cannot map. Only fires on the exact 426 + errorMsg='unsupported version' pair.","commonSituations":"Running an EOL Rocket.Chat (e.g. old 3.x/4.x) months after cloud deprecation; air-gapped installations that skipped upgrades then got connected; snapshots restored from ancient versions; unusual version strings from fork builds failing cloud version checks.","solutions":["Upgrade the Rocket.Chat server to a currently supported release, then reload the marketplace page.","Verify the reported server version (Administration -> Info) matches what you expect; fork/custom version strings can trip cloud checks.","If upgrading is blocked short-term, install apps manually via app upload (private apps / manual zip) instead of the marketplace browser.","Check cloud release notes for the minimum supported version before planning the upgrade target."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"// Guard before rendering the marketplace browser\nimport semver from 'semver';\nconst MIN_CLOUD_VERSION = '6.x'; // per current cloud support policy\nconst canBrowseMarketplace = (): boolean => semver.satisfies(parseServerVersion(), MIN_CLOUD_VERSION);","typeGuard":null,"tryCatchPattern":"try {\n  const apps = await fetchMarketplaceApps();\n} catch (e) {\n  if (e instanceof MarketplaceUnsupportedVersionError) {\n    renderUpgradeRequiredBanner(); // do not retry; only an upgrade changes the outcome\n  }\n}","preventionTips":["Stay on supported Rocket.Chat releases; plan upgrades before cloud deprecation windows close.","Surface this error as an explicit 'upgrade required' state, not a generic failure.","For frozen fleets, use manual zip installs instead of the marketplace browser."],"tags":["marketplace","versioning","cloud","upgrade-required","enterprise"],"backgroundTag":"api-version-unsupported","analyzedSha":"b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0","analyzedAt":"2026-08-18T15:26:39.429Z","contentChangedAt":"2026-08-18T15:26:39.429Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}