RocketChat/Rocket.Chat · error · MarketplaceUnsupportedVersionError

Marketplace_Unsupported_Version

Error message

Marketplace_Unsupported_Version

What it means

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.

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 f9d3ec372b)

Solutions

  1. Update Rocket.Chat to a supported release (Administration > Info or the official upgrade path).
  2. If on a nightly/dev build, switch to a stable release.
  3. Check Rocket.Chat release notes for the current minimum supported marketplace version.
  4. If you cannot upgrade, use offline app installation (upload zip) instead of the marketplace.
Defensive patterns

Strategy: try-catch

Validate before calling

function currentVersionSupported(minSupported: string): boolean {
  return compareVersions(Meteor.release, '>=', minSupported);
}

Type guard

import { MarketplaceUnsupportedVersionError } from './marketplaceErrors';

const isUnsupportedVersionError = (e: unknown): e is MarketplaceUnsupportedVersionError =>
  e instanceof MarketplaceUnsupportedVersionError;

Try / catch

try {
  return await fetchMarketplaceApps();
} catch (e) {
  if (e instanceof MarketplaceUnsupportedVersionError) {
    // prompt admin to upgrade Rocket.Chat; marketplace is not available on this version
    notifyAdminUpgradeRequired();
    return [];
  }
  throw e;
}

Prevention

When it happens

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

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

Related errors

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