[DOCS] Settings page missing `spinnerTipsOverride` configuration documentation

Resolved 💬 2 comments Opened Feb 17, 2026 by coygeek Closed Feb 19, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

"Customization settings" table

Current Documentation

The settings page documents two spinner-related settings:

| spinnerVerbs | Customize the action verbs shown in the spinner and turn duration messages. Set mode to "replace" to use only your verbs, or "append" to add them to the defaults | {"mode": "append", "verbs": ["Pondering", "Crafting"]} | | spinnerTipsEnabled | Show tips in the spinner while Claude is working. Set to false to disable tips (default: true) | false |

No documentation exists for spinnerTipsOverride.

What's Wrong or Missing?

Claude Code v2.1.45 added a spinnerTipsOverride setting that allows users to customize spinner tip content. The setting supports:

  • A tips array of custom tip strings
  • An optional excludeDefault: true flag to show only custom tips instead of the built-in ones

The settings page documents spinnerTipsEnabled (toggle tips on/off) and spinnerVerbs (customize action verbs), but does not document spinnerTipsOverride (customize the actual tip text). Users who want to customize what tips are shown have no way to discover this setting from the documentation.

Suggested Improvement

Add a row to the Customization settings table:

| Setting | Description | Example |
|---------|-------------|---------|
| spinnerTipsOverride | Customize the tips shown in the spinner while Claude is working. Configure tips with an array of custom tip strings. Set excludeDefault: true to show only your custom tips instead of the built-in ones | {"tips": ["Try /compact to save context", "Use @file to reference files"], "excludeDefault": true} |

Place it adjacent to the existing spinnerVerbs and spinnerTipsEnabled rows to group all spinner customization together.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | Customization settings table — missing spinnerTipsOverride row |

Total scope: 1 page affected

Source: Changelog v2.1.45 — "Added spinnerTipsOverride setting to customize spinner tips — configure tips with an array of custom tip strings, and optionally set excludeDefault: true to show only your custom tips instead of the built-in ones"

View original on GitHub ↗

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