[DOCS] Plugin management docs missing organization-level plugin force-disable mechanism
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/plugin-marketplaces
Section/Topic
Organization plugin management — the mechanism for administrators to force-disable specific installed plugins
Current Documentation
The plugin marketplaces page documents organization-level marketplace restrictions via managed settings:
strictKnownMarketplaces— restricts which marketplaces users can accessblockedMarketplaces— blocks specific marketplace URLs
These controls operate at the marketplace level (allowing or blocking entire sources), not at the individual plugin level.
What's Wrong or Missing?
Changelog v2.1.75 states: "Fixed managed-disabled plugins showing up in the /plugin Installed tab — plugins force-disabled by your organization are now hidden."
This reveals that organizations have a mechanism to force-disable specific individual plugins (not just restrict marketplace sources). This capability is not documented anywhere:
- The plugin marketplaces page covers marketplace-level restrictions only
- The settings page lists managed settings keys but does not include a key for disabling individual plugins
- No documentation explains how an administrator would mark a specific plugin as force-disabled
Enterprise and Team administrators who need to restrict specific plugins from their organization have no documentation to reference for this capability.
Suggested Improvement
Add a section to the plugin marketplaces page (or the managed settings section of the settings page) documenting:
- The managed settings key or mechanism used to force-disable individual plugins
- What happens to a force-disabled plugin from the user's perspective (hidden from Installed tab, cannot be re-enabled)
- Example configuration showing how an admin would disable a specific plugin
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/plugin-marketplaces | Marketplace-level restrictions documented, individual plugin disable not covered |
| https://code.claude.com/docs/en/settings | Managed settings keys listed, no individual plugin disable key |
Total scope: 2 pages affected
Source: Changelog v2.1.75 — "Fixed managed-disabled plugins showing up in the /plugin Installed tab — plugins force-disabled by your organization are now hidden"
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗