Answer: You define `userConfig` as an object whose keys are identifiers made of letters, digits, and underscores (not starting with a digit), and each value is a strict object with fields including `type`, `title`, and `description` (required), plus optional `required`, `default`, `options`, `multiple`, `sensitive`, and `min`/`max`. Status: Confirmed Entry: tool/claude-code/settings/plugin-userconfig-schema Revision: 5 Digest: sha256:8f5ada8ccde565ec (changes whenever the content changes) Timeline: Created: 2026-11-13T03:05:06Z Last changed: 2026-11-20T12:23:19Z (min/max field: — → Bounds for `number`) Last verified: 2026-11-20T12:23:19Z Next check: 2026-11-21T12:23:19Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of userConfig purpose | declares values Claude Code prompts the user for when the plugin is enabled | [1] | 2026-11-20 key format | letters, digits, and underscores | [1] | 2026-11-20 required fields | type | [1] | 2026-11-20 title field | Label shown in the configuration dialog | [1] | 2026-11-20 description field | Help text shown beneath the field | [1] | 2026-11-20 options field | the values the field accepts, shown as a picker in `/config` | [1] | 2026-11-20 sensitive field | masks input and stores the value in secure storage instead of `settings.json` | [1] | 2026-11-20 min/max field | Bounds for `number` | [1] | 2026-11-20 Sources: [1] Anthropic. "Plugin manifest reference". https://code.claude.com/docs/en/plugins/manifest-reference.md Role: primary. Accessed: 2026-11-20T12:23:19Z Quote: "`userConfig` declares values Claude Code prompts the user for when the plugin is enabled" (Supports: userConfig purpose) Quote: "Keys are identifiers made of letters, digits, and underscores, and can't start with a digit." (Supports: key format) Quote: "| `type` | Yes | One of `string`, `number`, `boolean`, `directory`, or `file` |" (Supports: required fields) Quote: "| `title` | Yes | Label shown in the configuration dialog |" (Supports: title field) Quote: "| `description` | Yes | Help text shown beneath the field |" (Supports: description field) Quote: "| `options` | No | For `string`, the values the field accepts, shown as a picker in `/config`." (Supports: options field) Quote: "| `sensitive` | No | If `true`, masks input and stores the value in secure storage instead of `settings.json` |" (Supports: sensitive field) Quote: "| `min` / `max` | No | Bounds for `number` |" (Supports: min/max field) Published: 2026-11-20T02:54:47Z Snapshot SHA-256: 881277b37c7b02ec0c5212ee0d1a4498de38c52a3e83b9fc2f0853ed16a76504 (captured 2026-11-20T12:23:18Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. Cross-check: not-available at 2026-11-20T12:23:19Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:23:19Z Last attempt: 2026-11-20T12:23:19Z Notes and limitations: Extracted automatically from a single official source (section "User configuration"). Related: https://latestn.com/tool/claude-code/settings/raise-background-command-time-limit How do I raise the time limit for background commands in Claude Code? https://latestn.com/tool/claude-code/settings/reenable-lsp-recommendations How do I turn code intelligence plugin recommendations back on in Claude Code? https://latestn.com/tool/claude-code/settings/region-configuration How do I configure the region for Claude Code on Google Cloud's Agent Platform? https://latestn.com/tool/claude-code/settings/plugin-install-scopes What are the install scopes for Claude Code plugins? https://latestn.com/tool/claude-code/settings/plugin-manifest-fields What fields can I set in a Claude Code plugin's plugin.json manifest? https://latestn.com/tool/claude-code/settings/plugin-marketplace-auto-update How do I turn auto-update on or off for a Claude Code plugin marketplace? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-20T12:23:19Z | changed | min/max field: — → Bounds for `number` | [1] 2026-11-20T12:23:19Z | changed | sensitive field: — → masks input and stores the value in secure storage instead of `settings.json` | [1] 2026-11-20T12:23:19Z | changed | options field: — → the values the field accepts, shown as a picker in `/config` | [1] 2026-11-20T12:23:19Z | changed | description field: — → Help text shown beneath the field | [1] 2026-11-20T12:23:19Z | changed | title field: — → Label shown in the configuration dialog | [1] 2026-11-20T12:23:19Z | changed | required fields: — → type | [1] 2026-11-20T12:23:19Z | changed | key format: — → letters, digits, and underscores | [1] 2026-11-20T12:23:19Z | changed | sensitive behavior: masks input and stores the value in secure storage instead of `settings.json` → — | [1] 2026-11-20T12:23:19Z | changed | options version requirement: v2.1.271 → — | [1] 2026-11-20T12:23:19Z | changed | key naming rule: letters, digits, and underscores, and can't start with a digit → — | [1] 2026-11-20T12:23:19Z | changed | type values: `string`, `number`, `boolean`, `directory`, or `file` → — | [1] 2026-11-18T12:18:34Z | changed | sensitive behavior: — → masks input and stores the value in secure storage instead of `settings.json` | [1] 2026-11-18T12:18:34Z | changed | key naming rule: — → letters, digits, and underscores, and can't start with a digit | [1] 2026-11-18T12:18:34Z | changed | config rows version requirement: v2.1.269 → — | [1] 2026-11-18T12:18:34Z | changed | key format: letters, digits, and underscores → — | [1] 2026-11-14T12:19:02Z | changed | config rows version requirement: — → v2.1.269 | [1] 2026-11-14T12:19:02Z | changed | options version requirement: — → v2.1.271 | [1] 2026-11-14T12:19:02Z | changed | type values: — → `string`, `number`, `boolean`, `directory`, or `file` | [1] 2026-11-14T12:19:02Z | changed | min/max field: Bounds for `number` → — | [1] 2026-11-14T12:19:02Z | changed | sensitive field: If `true`, masks input and stores the value in secure storage instead of `settings.json` → — | [1] 2026-11-14T12:19:02Z | changed | description field: Help text shown beneath the field → — | [1] 2026-11-14T12:19:02Z | changed | title field: Label shown in the configuration dialog → — | [1] 2026-11-14T12:19:02Z | changed | type field: One of `string`, `number`, `boolean`, `directory`, or `file` → — | [1] 2026-11-14T12:19:02Z | changed | key format: letters, digits, and underscores, and can't start with a digit → letters, digits, and underscores | [1] 2026-11-13T12:12:46Z | changed | min/max field: — → Bounds for `number` | [1] 2026-11-13T12:12:46Z | changed | type field: — → One of `string`, `number`, `boolean`, `directory`, or `file` | [1] 2026-11-13T12:12:46Z | changed | sensitive field: masks input and stores the value in secure storage instead of `settings.json` → If `true`, masks input and stores the value in secure storage instead of `settings.json` | [1] 2026-11-13T12:12:46Z | changed | options version requirement: v2.1.271 → — | [1] 2026-11-13T12:12:46Z | changed | type values: string → — | [1] 2026-11-13T12:12:46Z | changed | required fields: type → — | [1] 2026-11-13T03:05:06Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/settings/plugin-userconfig-schema/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/settings/plugin-userconfig-schema POST: https://latestn.com/dispute/tool/claude-code/settings/plugin-userconfig-schema with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/settings/plugin-userconfig-schema?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I define userConfig options in a Claude Code plugin manifest? Revision 5, last verified 2026-11-20T12:23:19Z. https://latestn.com/tool/claude-code/settings/plugin-userconfig-schema (accessed 2026-11-21T09:52:23Z). @misc{LatestN_tool_claude_code_settings_plugin_userconfig_schema_r5, title = {How do I define userConfig options in a Claude Code plugin manifest?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/settings/plugin-userconfig-schema}}, note = {Revision 5; digest sha256:8f5ada8ccde565ec; last verified 2026-11-20T12:23:19Z; accessed 2026-11-21T09:52:23Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/settings/plugin-userconfig-schema