{"record":{"id":"edf5318a5c0b3f61","repo":"RocketChat/Rocket.Chat","slug":"marketplace-unsupported-version","errorCode":null,"errorMessage":"Marketplace_Unsupported_Version","messagePattern":"Marketplace_Unsupported_Version","errorType":"error_code","errorClass":"MarketplaceUnsupportedVersionError","httpStatus":null,"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/f9d3ec372bb580fa8d036f94cf03925a478ef768/apps/meteor/ee/server/apps/marketplace/fetchMarketplaceApps.ts#L164-L197","documentation":"Thrown by fetchMarketplaceApps when the marketplace responds with HTTP 426 (Upgrade Required) AND the JSON body has errorMsg === 'unsupported version'. Maps to MarketplaceUnsupportedVersionError, whose message is 'Marketplace_Unsupported_Version'. This signals the Rocket.Chat client version is too old (or too new) for the marketplace API contract. The TODO comment notes cloud should eventually return a proper error code.","triggerScenarios":"Calling fetchMarketplaceApps() on a Rocket.Chat version the marketplace no longer supports, or a dev/build version ahead of what the marketplace expects. The marketplace explicitly returns 426 with errorMsg 'unsupported version'.","commonSituations":"Running an outdated Rocket.Chat release against the live marketplace; running an unreleased/nightly build; marketplace raised its minimum supported version; downgrade scenario where the marketplace rejects the older client.","solutions":["Update Rocket.Chat to a supported release (Administration > Info or the official upgrade path).","If on a nightly/dev build, switch to a stable release.","Check Rocket.Chat release notes for the current minimum supported marketplace version.","If you cannot upgrade, use offline app installation (upload zip) instead of the marketplace."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":"function currentVersionSupported(minSupported: string): boolean {\n  return compareVersions(Meteor.release, '>=', minSupported);\n}","typeGuard":"import { MarketplaceUnsupportedVersionError } from './marketplaceErrors';\n\nconst isUnsupportedVersionError = (e: unknown): e is MarketplaceUnsupportedVersionError =>\n  e instanceof MarketplaceUnsupportedVersionError;","tryCatchPattern":"try {\n  return await fetchMarketplaceApps();\n} catch (e) {\n  if (e instanceof MarketplaceUnsupportedVersionError) {\n    // prompt admin to upgrade Rocket.Chat; marketplace is not available on this version\n    notifyAdminUpgradeRequired();\n    return [];\n  }\n  throw e;\n}","preventionTips":["Keep Rocket.Chat on a marketplace-supported release.","Handle MarketplaceUnsupportedVersionError by surfacing an upgrade prompt, not a generic error.","Avoid running unreleased nightlies against the production marketplace.","Offer offline zip install as a fallback when upgrade is delayed."],"tags":["marketplace","version","upgrade","compatibility"],"backgroundTag":null,"analyzedSha":"f9d3ec372bb580fa8d036f94cf03925a478ef768","analyzedAt":"2026-08-12T19:07:17.372Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}