[DOCS] Plugin marketplaces docs missing `source: 'settings'` inline plugin declaration

Resolved 💬 2 comments Opened Mar 19, 2026 by coygeek Closed Mar 20, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/plugin-marketplaces

Section/Topic

"Plugin sources" table listing valid source types

Current Documentation

The plugin-marketplaces page documents plugin source types in the "Plugin sources" table:

| Source | Description | |--------|-------------| | Relative path | ./my-plugin | | github | GitHub repository | | url | Direct URL | | git-subdir | Subdirectory in a git repo | | npm | npm package | | pip | pip package |

The settings page also documents extraKnownMarketplaces source types including github, git, url, npm, file, directory, hostPattern, and pathPattern.

Neither page mentions source: 'settings' as a valid source type.

What's Wrong or Missing?

Changelog v2.1.80 added source: 'settings' as a plugin marketplace source, allowing users to declare plugin entries inline directly in settings.json. This source type is not documented in any plugin-related page.

Users who want to define plugins inline in their settings.json — without hosting them externally or using a marketplace — have no documentation explaining this capability, its syntax, or when to use it.

Suggested Improvement

Add a settings row to the "Plugin sources" table:

| Source | Description |
|--------|-------------|
| settings | Declare plugin entries inline in settings.json |

Add a section or example showing how to use source: 'settings' to define a plugin entry directly within settings.json, including the expected schema for inline plugin declarations.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/plugin-marketplaces | "Plugin sources" table |
| https://code.claude.com/docs/en/settings | extraKnownMarketplaces source type documentation |

Total scope: 2 pages affected

Source: Changelog v2.1.80

Added source: 'settings' plugin marketplace source — declare plugin entries inline in settings.json

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗