RocketChat/Rocket.Chat · error · MarketplaceUnsupportedVersionError

Marketplace_Unsupported_Version

Error message

Marketplace_Unsupported_Version

What it means

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.

Solutions

1. Upgrade the Rocket.Chat server to a currently supported release, then reload the marketplace page.
2. Verify the reported server version (Administration -> Info) matches what you expect; fork/custom version strings can trip cloud checks.
3. If upgrading is blocked short-term, install apps manually via app upload (private apps / manual zip) instead of the marketplace browser.
4. Check cloud release notes for the minimum supported version before planning the upgrade target.

// Guard before rendering the marketplace browser
import semver from 'semver';
const MIN_CLOUD_VERSION = '6.x'; // per current cloud support policy
const canBrowseMarketplace = (): boolean => semver.satisfies(parseServerVersion(), MIN_CLOUD_VERSION);

try {
  const apps = await fetchMarketplaceApps();
} catch (e) {
  if (e instanceof MarketplaceUnsupportedVersionError) {
    renderUpgradeRequiredBanner(); // do not retry; only an upgrade changes the outcome
  }
}

When it happens

Trigger: 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.

Common situations: 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.

Related errors

• Marketplace_Unsupported_Version
• Marketplace_Invalid_Apps_Engine_Version
• App metadata download failed
• App package download failed
• Invalid response from the Marketplace

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

Appendix: source

Thrown at apps/meteor/ee/server/apps/marketplace/fetchMarketplaceApps.ts:182

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

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

	const response = await request.json();

	Apps.getRocketChatLogger().error({ msg: 'Error fetching marketplace apps', 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();
	}

	if (request.status === 400 && response.code === 200) {
		throw new MarketplaceAppsError('Marketplace_Invalid_Apps_Engine_Version');
	}

	const INTERNAL_MARKETPLACE_ERROR_CODES = [266, 256, 166, 221, 257, 320];

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

	throw new MarketplaceAppsError('Marketplace_Failed_To_Fetch_Apps');
}

View on GitHub (pinned to b2c16d5842)