[DOCS] Prompt input documentation omits emoji shortcode autocomplete and `emojiCompletionEnabled`

Status Fixed / completed
Reported on v2.1.217
Maintainer reply None cached
Activity 1 comment · opened Jul 22, 2026 · closed Aug 16, 2026

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 /config and settings.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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗