[DOCS] Image paste from clipboard lacks loading/feedback indicator
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/interactive-mode
Section/Topic
Keyboard shortcuts table — image paste rows (Ctrl+V / Cmd+V / Alt+V)
Current Documentation
The keyboard shortcuts table at https://code.claude.com/docs/en/interactive-mode describes image paste with:
Ctrl+VorCmd+V(iTerm2) orAlt+V(Windows) | Paste image from clipboard | Inserts an[Image #N]chip at the cursor so you can reference it positionally in your prompt
This describes the end result but omits the loading experience. When a user pastes a large image from the clipboard with Ctrl+V, there is no feedback in the UI while the image data is being read — the cursor simply sits idle until the [Image #N] chip appears moments later. Users on slower machines or with large images cannot tell whether the operation is in progress or has silently failed.
What's Wrong or Missing?
A. No loading feedback during image paste
When pasting an image from the clipboard, especially a large one, the UI gives no indication that the paste is in progress. The prompt area shows nothing until the [Image #N] chip materializes, which can take several seconds on large images or over slow connections (e.g., SSH, remote containers).
B. Footer hint not documented
v2.1.132 added a "Pasting…" footer hint to communicate that an image paste is in progress, but this UI element is not documented anywhere — neither in the interactive-mode page nor in the status-line customisation docs. A user who relies on documented behaviour has no way to know this feedback exists.
Suggested Improvement
Add a note to the keyboard shortcuts table row for Ctrl+V / Cmd+V / Alt+V image paste in https://code.claude.com/docs/en/interactive-mode:
> **Note:** Large image pastes may take a moment to process. A "Pasting…" footer hint appears while the image is being read from the clipboard.
Alternatively, expand the "Context" column description to include the loading feedback. This helps users understand what to expect and reduces support queries about "frozen" or unresponsive paste behaviour.
Impact
Medium - Makes feature difficult to understand
Additional Context
Changelog entry (v2.1.132):
Added a "Pasting…" footer hint while a Ctrl+V image paste is being read from the clipboard
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/interactive-mode | Primary keyboard shortcuts table — image paste shortcut rows |
Total scope: 1 page
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗