Claude Code Plugins Marketplace

Claude Code Plugins: Marketplace

A marketplace is a marketplace.json file that lists plugins and where to get them. A team can host one so that each member installs the same plugins. For example, claude plugin marketplace add owner/repo adds a marketplace from a GitHub repo. The marks are explained on Plugins.

Top-Level Keys

File: .claude-plugin/marketplace.json. An unknown key is ignored and validate warns.

Mark	Item	What It Does	How It Works	Where It Can Be Used	Source
✅	name	Marketplace id.	Letters, digits, ., _, -. Many reserved names (official, inline, builtin, skills-dir, synced, npm, github, claudeai- prefix, JavaScript member names).	marketplace.json	Plugin Manifest Reference, Marketplace Reference
✅	owner	Maintainer.	name required, email, url.	marketplace.json	Marketplace Reference, Host and Maintain a Marketplace
✅	plugins	Entries.	An invalid entry becomes a stub with source unsupported. Others still load.	marketplace.json	Marketplace Reference, Plugin Commands Reference
✅	$schema, description, version	Info.	metadata.description and metadata.version are alternates.	marketplace.json	Plugin Manifest Reference, Marketplace Reference
✅	metadata.pluginRoot	Base for bare source names.	v2.1.239 or later. Must be inside the marketplace.	marketplace.json	Marketplace Reference
✅	forceRemoveDeletedPlugins	Uninstalls removed plugins.	Boolean.	marketplace.json	Marketplace Reference, Host and Maintain a Marketplace
✅	allowCrossMarketplaceDependenciesOn	Allowed dependency marketplaces.	Array of names.	marketplace.json	Marketplace Reference, Host and Maintain a Marketplace
✅	renames	Old name to new name or null.	Append-only map.	marketplace.json	Marketplace Reference, Host and Maintain a Marketplace

Plugin Entry Keys

An entry also accepts every plugin.json key except the directory listing fields. See Manifest.

Mark	Item	What It Does	How It Works	Where It Can Be Used	Source
✅	name, source	Required id and place.	The entry name is what users type before @.	entry	Plugin Manifest Reference, Marketplace Reference
✅	category, tags	Catalog data.	Free text.	entry	Marketplace Reference, Environment Variables
✅	strict	Manifest authority.	Default true. With false and a plugin.json, component keys in the entry cause conflicting manifests.	entry	Plugin Manifest Reference, Marketplace Reference
✅	headers, headersHelper	Archive download headers.	v2.1.238 or later. headersHelper needs strict: false. Only for archive.	entry	Plugin Manifest Reference, Marketplace Reference
✅	defaultEnabled, displayName, dependencies, metadata	As in the manifest.	Entry values override for display and defaultEnabled.	entry	Plugin Manifest Reference, Marketplace Reference
✅	relevance	When to suggest the plugin.	topic (64 characters) and signals: cli, hosts, filesRead, manifestDeps (file + pattern), cwd. Each list has limits (10 or 20). Needs setting pluginSuggestionMarketplaces.	entry	Marketplace Reference, Manage Claude Code Plugins for Your Organization
✅	experimental in an entry	Component declarations.	Validate warns when it is not an object.	entry	Plugin Manifest Reference, Plugin Commands Reference

Plugin Sources

Mark	Item	What It Does	How It Works	Where It Can Be Used	Source
✅	Relative path string	A folder in the marketplace.	Starts with ./, no .., no backslash. Bare name only under metadata.pluginRoot.	entry	Marketplace Reference
✅	github	repo, ref, sha.	sha is 40 lowercase hex.	entry	Marketplace Reference, Plugin Commands Reference
✅	url	url, ref, sha.	A git URL.	entry	Plugin Manifest Reference, Marketplace Reference
✅	git-subdir	url, path, ref, sha.	Sparse, partial clone.	entry	Marketplace Reference, Plugin Loading Reference
✅	npm	package, version, registry.	Install scripts never run. Git, file, and alias specs refused.	entry	Marketplace Reference, Plugin Loading Reference
✅	archive	url, sha256.	HTTPS zip. v2.1.224 or later.	entry	Marketplace Reference, Plugin Loading Reference
✅	command	command, timeout (1 to 600, default 60), mode (copy or link).	Prints one absolute path. 500 characters at most. Copy limit 256 MiB or 20,000 entries. Link not on Windows. Off with disableCommandPluginSources.	entry	Plugin Manifest Reference, Marketplace Reference
🔍	unsupported	Placeholder source.	Made by the parser. An author cannot write it.	entry	bundle

Marketplace Sources

Used by extraKnownMarketplaces, strictKnownMarketplaces, blockedMarketplaces.

Mark	Item	What It Does	How It Works	Where It Can Be Used	Source
✅	github	repo, ref, path, sparsePaths.	owner/* only in policy lists.	all three	Marketplace Reference, Plugin Commands Reference
✅	git	url, ref, path, sparsePaths.	skipLfs is accepted and ignored.	all three	Marketplace Reference, Plugin Commands Reference
✅	url	url, headers, headersHelper.	Fetches only the JSON file, so no relative sources.	all three	Plugin Manifest Reference, Marketplace Reference
✅	file, directory	path.	Read in place.	all three	Plugin Manifest Reference, Marketplace Reference
✅	settings	name, plugins, owner.	Inline catalog. Entries need remote sources.	extraKnownMarketplaces	Plugin Manifest Reference, Marketplace Reference
✅	npm	package.	Fails to load: "NPM marketplace sources not yet implemented".	policy lists parse it	Marketplace Reference, Plugin Loading Reference
✅	skills-dir, hostPattern, pathPattern	Policy-only values.	skills-dir keeps skills-directory plugins loading under an allowlist. Patterns are regular expressions.	policy lists	Marketplace Reference, Plugin Loading Reference

Settings Keys

Mark	Item	What It Does	How It Works	Where It Can Be Used	Source
✅	extraKnownMarketplaces	Declares marketplaces.	Map name to { "source": ... }. Project values apply after trust.	settings	Marketplace Reference, Plugin Commands Reference
✅	additionalMarketplaces	Alias of extraKnownMarketplaces.	Ignored with a warning if both are set.	settings	Manage Claude Code Plugins for Your Organization, Settings Reference
✅	strictKnownMarketplaces	Allowlist.	Checked before download. Does not register.	managed settings	Marketplace Reference, Manage Claude Code Plugins for Your Organization
✅	allowedMarketplaces	Alias of strictKnownMarketplaces.	Managed only.	managed settings	Manage Claude Code Plugins for Your Organization, Settings Reference
✅	blockedMarketplaces	Blocklist.	Checked before download.	managed settings	Marketplace Reference, Manage Claude Code Plugins for Your Organization
✅	pluginSuggestionMarketplaces	Marketplaces that may suggest plugins.	Without it no marketplace suggestion shows.	settings	Manage Claude Code Plugins for Your Organization, Host and Maintain a Marketplace
✅	disableCommandPluginSources	Turns off command sources.	Managed.	managed settings	Marketplace Reference, Manage Claude Code Plugins for Your Organization

See Also

• Marketplace Reference is the docs page.
• Manifest covers plugin.json.