What causes "Marketplace_Unsupported_Version" in RocketChat/Rocket.Chat?

Update Rocket.Chat to a marketplace-supported release.

RocketChat/Rocket.Chat · error · MarketplaceUnsupportedVersionError

Marketplace_Unsupported_Version

Error message

Marketplace_Unsupported_Version

What it means

Thrown by fetchMarketplaceCategories when the marketplace responds with HTTP 426 and errorMsg === 'unsupported version'. Maps to MarketplaceUnsupportedVersionError (message 'Marketplace_Unsupported_Version'). Identical semantics to the apps variant: the client version is not supported by the marketplace. Note the categories variant has a smaller INTERNAL_MARKETPLACE_ERROR_CODES list [189, 266] and no 400-code-200 branch.

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

Solutions

Update Rocket.Chat to a marketplace-supported release.
Switch from nightly/dev to stable if applicable.
Consult release notes for the current minimum supported version.
If upgrade is impossible, treat marketplace categories as unavailable.

Defensive patterns

Strategy: try-catch

Validate before calling

function currentVersionSupportedForCategories(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 fetchMarketplaceCategories();
} catch (e) {
  if (e instanceof MarketplaceUnsupportedVersionError) {
    notifyAdminUpgradeRequired();
    return [];
  }
  throw e;
}

Prevention

Keep Rocket.Chat on a marketplace-supported release.
Handle MarketplaceUnsupportedVersionError by prompting an upgrade, not a generic error.
Cache category data so a stale view is available when the marketplace rejects the version.
Treat categories as non-critical; degrade gracefully.

When it happens

Trigger: Calling fetchMarketplaceCategories() on a Rocket.Chat version the marketplace no longer supports, returning 426 with errorMsg 'unsupported version'.

Common situations: Outdated Rocket.Chat release against the live marketplace; nightly/dev build ahead of marketplace support; marketplace raised its minimum version; downgrade scenario.

Related errors

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