[DOCS] Prompt input documentation omits emoji shortcode autocomplete and `emojiCompletionEnabled`
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/settings
Section/Topic
The Available settings table and the prompt-input behavior configured by /config.
Current Documentation
The settings page currently says:
Claude Code offers a variety of settings to configure its behavior to meet your needs. You can configure Claude Code by running the /config command in an interactive session, which opens a tabbed Settings interface where you can view status information and modify configuration options.
The page also introduces the settings table with:
settings.json supports a number of options:
There is no entry describing emoji shortcode completion, the emojiCompletionEnabled setting, or how prompt-input completion behaves.
What's Wrong or Missing?
Claude Code v2.1.217 adds a user-visible prompt-input feature: typing a complete shortcode such as :heart: inserts the corresponding emoji, while typing a prefix such as :hea offers suggestions. The release also adds emojiCompletionEnabled as the opt-out setting.
Users cannot discover this behavior or configure it from the settings reference. The absence is especially problematic because the feature changes how colon-prefixed text is handled in the prompt input, while the documented /config and settings.json surfaces do not identify the setting.
Suggested Improvement
Add an emojiCompletionEnabled row to the settings reference and a short prompt-input subsection that documents:
- How to type a complete shortcode, such as
:heart:, to insert an emoji. - How a partial shortcode, such as
:hea, opens suggestions. - The default value and the accepted boolean values for
emojiCompletionEnabled. - How to disable the behavior through
/configandsettings.json, with a minimal configuration example. - Whether the setting applies at user, project, local, or managed scope and when a changed value takes effect.
Add a link from the setting row to the prompt-input explanation so users who find the setting first can understand what it controls.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/settings | 9, 213-218 | /config introduction and the Available settings table; no emojiCompletionEnabled entry |
Total scope: 1 page currently lacks the setting and prompt-input explanation.
The relevant release is Claude Code v2.1.217. The release entry is listed in the Claude Code changelog under version 2.1.217.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗