Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix AskUserQuestion: option description not shown when preview is present [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#45384•Fetched 2026-04-09 08:06:40
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
marcospgpmarcospgp
Participants
marcospgpmarcospgp
Timeline (top)
labeled ×4

Code Example

{
  "questions": [{
    "question": "A",
    "header": "B",
    "options": [
      { "label": "C", "description": "D", "preview": "E" },
      { "label": "F", "description": "G", "preview": "H" }
    ],
    "multiSelect": false
  }]
}

---

{
  "options": [
    { "label": "C", "description": "D" },
    { "label": "F", "description": "G" }
  ]
}
RAW_BUFFERClick to expand / collapse

Bug

When an AskUserQuestion option includes a preview field, the description field is not rendered in the UI.

Steps to reproduce

  1. Call AskUserQuestion with options that have both description and preview fields:
{
  "questions": [{
    "question": "A",
    "header": "B",
    "options": [
      { "label": "C", "description": "D", "preview": "E" },
      { "label": "F", "description": "G", "preview": "H" }
    ],
    "multiSelect": false
  }]
}
  1. Only label and preview are rendered. description is silently dropped.

Without preview (working correctly)

When preview is omitted, description renders correctly below each option label.

{
  "options": [
    { "label": "C", "description": "D" },
    { "label": "F", "description": "G" }
  ]
}

Expected behavior

Both description and preview should be visible, since the schema accepts both fields simultaneously. If description is intentionally hidden in preview mode, the tool schema docs should say so explicitly — currently they only mention the layout switches to side-by-side, not that descriptions are dropped.

Screenshots

With preview — description missing

with-preview

Without preview — description visible

without-preview

Environment

  • Claude Code CLI (macOS)
  • Tested 2026-04-08

extent analysis

TL;DR

The issue can be mitigated by removing the preview field from the AskUserQuestion options or by adjusting the UI rendering logic to include the description field when preview is present.

Guidance

  • Review the UI rendering logic to ensure it correctly handles options with both description and preview fields.
  • Verify the schema documentation to confirm if the omission of description when preview is present is intended behavior.
  • Test the AskUserQuestion function with different combinations of fields to identify any patterns or edge cases that may be contributing to the issue.
  • Consider adding a feature request to the tool's documentation to explicitly state how description and preview fields interact, if the current behavior is intended.

Example

No code snippet is provided as the issue seems to be related to the UI rendering logic, which is not explicitly stated in the issue.

Notes

The issue may be specific to the Claude Code CLI or the version being used, and further investigation is needed to determine the root cause.

Recommendation

Apply a workaround by removing the preview field or adjusting the UI rendering logic, as the root cause of the issue is unclear and may require further investigation.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

Both description and preview should be visible, since the schema accepts both fields simultaneously. If description is intentionally hidden in preview mode, the tool schema docs should say so explicitly — currently they only mention the layout switches to side-by-side, not that descriptions are dropped.

#callback error#memory management#API rate limit#retriever error#indexing error

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix AskUserQuestion: option description not shown when preview is present [1 participants]