RocketChat/Rocket.Chat · error · MarketplaceUnsupportedVersionError

Marketplace_Unsupported_Version

Error message

Marketplace_Unsupported_Version

What it means

MarketplaceUnsupportedVersionError ('Marketplace_Unsupported_Version') from fetchMarketplaceCategories: identical semantics to 170 but for the categories listing — the cloud responds 426 Upgrade Required with errorMsg 'unsupported version', declaring this server version cannot use the marketplace categories API. The response is logged as 'Error fetching marketplace categories' before the throw.

Solutions

1. Upgrade the server to a supported release and reload the marketplace explorer.
2. Verify reported version in Administration -> Info.
3. Use direct app installs (zip upload or app ID) while an upgrade is scheduled.
4. Confirm the cloud minimum-version policy in release notes when choosing the upgrade target.

try {
  const cats = await fetchMarketplaceCategories();
} catch (e) {
  if (e instanceof MarketplaceUnsupportedVersionError) {
    renderUpgradeRequiredBanner(); // categories and apps both require a supported server version
  }
}

When it happens

Trigger: Loading the marketplace EXPLORER which fetches categories, on a server version the cloud has deprecated; the apps list may separately succeed or fail with its own error (170), but this throw is specifically the categories call.

Common situations: Old/EOL server builds after cloud deprecation windows; restored snapshots from deprecated versions; fork builds with unrecognized version strings.

Related errors

• Marketplace_Unsupported_Version
• Marketplace_Failed_To_Fetch_Categories
• Marketplace_Internal_Error
• Marketplace_Invalid_Apps_Engine_Version
• App metadata download failed

AI-assisted analysis of RocketChat/Rocket.Chat@b2c16d5842 (2026-08-18). Data as JSON: /api/errors/7695063f858c92f4. Report an issue: GitHub.

Appendix: source

Thrown at apps/meteor/ee/server/apps/marketplace/fetchMarketplaceCategories.ts:66

		if (error instanceof CloudOfflineLicenseError) {
			throw error;
		}
		throw new MarketplaceConnectionError('Marketplace_Bad_Marketplace_Connection');
	}

	if (request.status === 200) {
		const response = await request.json();
		fetchMarketplaceCategoriesSchema.parse(response);
		return response;
	}

	const response = await request.json();

	Apps.getRocketChatLogger().error({ msg: 'Error fetching marketplace categories', status: request.status, response });

	// TODO: Refactor cloud to return a proper error code on unsupported version
	if (request.status === 426 && 'errorMsg' in response && response.errorMsg === 'unsupported version') {
		throw new MarketplaceUnsupportedVersionError();
	}

	const INTERNAL_MARKETPLACE_ERROR_CODES = [189, 266];

	if (request.status === 500 && INTERNAL_MARKETPLACE_ERROR_CODES.includes(response.code)) {
		throw new MarketplaceAppsError('Marketplace_Internal_Error');
	}

	throw new MarketplaceAppsError('Marketplace_Failed_To_Fetch_Categories');
}

View on GitHub (pinned to b2c16d5842)