[DOCS] Settings page missing spinnerVerbs configuration documentation

Status Fixed / completed
Maintainer reply None cached
Activity 4 comments · opened Jan 29, 2026 · closed Jan 29, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Settings reference table (the table listing all available settings like spinnerTipsEnabled, showTurnDuration, etc.)

Current Documentation

No documentation currently exists for the spinnerVerbs setting. The settings page documents related settings like spinnerTipsEnabled (line 172 in current docs) but does not include spinnerVerbs.

What's Wrong or Missing?

Changelog v2.1.23 added a new setting called spinnerVerbs that allows users to customize the spinner verbs (the action words shown while Claude is working, like "Thinking", "Working", etc.). This setting is not documented in the settings reference.

Users who want to customize the spinner text have no way to discover this feature or learn:

  • What values the setting accepts (array of strings? object?)
  • What the default verbs are
  • Example configurations

Suggested Improvement

Add a row to the settings reference table:

| Setting | Description | Example |
|:--------|:------------|:--------|
| spinnerVerbs | Customize the action verbs displayed in the spinner while Claude is working. Provide an array of strings to replace the default verbs | ["Thinking", "Processing", "Working"] |

If the setting accepts more complex configuration (e.g., per-context verbs), document that structure as well.

Impact

Medium - Makes feature difficult to understand

Additional Context

Source: Changelog v2.1.23

Exact changelog entry:

"Added customizable spinner verbs setting (spinnerVerbs)"

The setting was added in v2.1.23 (current version as of January 2026). Related settings like spinnerTipsEnabled and showTurnDuration are already documented in the same table.

View original on GitHub ↗

4 Comments

dabrowski-adam · 8 months ago

This is the expected format:

  "spinnerVerbs": {                                                                                                                                                                                  
    "description": "Customize spinner verbs. mode: \"append\" adds verbs to defaults, \"replace\" uses only your verbs.",                                                                            
    "type": "object",                                                                                                                                                                                
    "properties": {                                                                                                                                                                                  
      "mode": {                                                                                                                                                                                      
        "type": "string",                                                                                                                                                                            
        "enum": ["append", "replace"]                                                                                                                                                                
      },                                                                                                                                                                                             
      "verbs": {                                                                                                                                                                                     
        "type": "array",                                                                                                                                                                             
        "items": {                                                                                                                                                                                   
          "type": "string"                                                                                                                                                                           
        }                                                                                                                                                                                            
      }                                                                                                                                                                                              
    },                                                                                                                                                                                               
    "required": ["mode", "verbs"],                                                                                                                                                                   
    "additionalProperties": false                                                                                                                                                                    
  }
nexusmedialab · 8 months ago

If you got this to work, explain:

  • The relative path of the settings file you modified to make it work
  • The actual code you put in the settings file to disable the time wasting nonsense spinner verbs
coygeek · 8 months ago

Issue #21599 Verification

Title: [DOCS] Settings page missing spinnerVerbs configuration documentation
Issue Date: 2026-01-29
Verification Date: 2026-01-29
Status: RESOLVED

---

Issue Summary

This issue reports that the spinnerVerbs setting (added in v2.1.23) is not documented in the settings reference table, making it impossible for users to discover or configure this feature.

---

Verification Results

Claim 1: spinnerVerbs is not documented

Status: RESOLVED

The spinnerVerbs setting is now documented at line 170 of the settings page:

| 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"]} |

Verdict: Documentation has been added since the issue was filed.

---

Claim 2: Related settings like spinnerTipsEnabled are documented

Status: Confirmed (still true)

spinnerTipsEnabled is documented at line 173:

| spinnerTipsEnabled | Show tips in the spinner while Claude is working. Set to false to disable tips (default: true) | false |

Verdict: Both settings are now documented in the same table.

---

Current State

| Claim | Status |
|-------|--------|
| spinnerVerbs not documented | RESOLVED |
| Related settings documented | Confirmed |

---

Suggested Fix

No fix needed. The documentation now includes all requested information:

  • Setting name: spinnerVerbs
  • Description of functionality
  • Configuration structure (mode and verbs fields)
  • Example configuration

---

References

---

Conclusion & Recommendation

Primary Concern: The spinnerVerbs setting was undocumented, preventing users from discovering or configuring custom spinner verbs.

Resolution Status: RESOLVED

Recommendation: CLOSE

The documentation now fully documents spinnerVerbs with a clear description and example showing both the mode and verbs configuration options, which is more detailed than what the reporter originally suggested.

github-actions[bot] · 8 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.