Icon

You might say

Add a small icon to the button so people can tell what it does without reading.

A small, consistent visual symbol for an action, object, or statusFamiliar icons such as search, download, and close help people scan quickly. For an unfamiliar or high-risk action, add text or a Tooltip.
⌕Search↓Download⚙Settings

You can say this to an AI Agent

Ready to paste into Cursor, Claude Code, or Codex
Vague phrasing & misuse

“Add a small icon to the button so people can tell what it does without reading.”

  • An unfamiliar action with only an icon
  • Unrelated dangerous actions mixed under More
Structured constraint prompt

Review the project toolbar: familiar actions may use consistent icons, but permanent deletion must also show explicit text and use a real button. Do not rely only on red or a tooltip, and verify keyboard access and the accessible name.

Want your Agent to translate plain-language UI ideas automatically?Install free VibeHub Skill →
Icon≠Image

Icon is a small reusable symbol for a function or concept. Image displays a photo, illustration, or content itself.

Icon≠Button

Icon communicates meaning. It becomes an icon button only when placed in a Button that runs an action.

When to use it

  • Common tool actions
    ⌕↓×Search · Download · Close
  • Compact toolbars
    ↶↷⌗⋯
  • Status cues with text
    ✓File synced

When NOT to use it

  • An unfamiliar action with only an icon
    ◈The icon’s meaning is unclear
  • Unrelated dangerous actions mixed under More
    ⋯Delete project is hidden under More
  • Emoji in place of consistent system icons
    ⬇📥⇩Three download icons with inconsistent styles
Anatomy
⌕Search
Keep the shape clear at small sizes
Add words for unfamiliar or important actions
Variants
Standalone
⌕
For decoration or a status cue only
Icon button
For a common action
With label
↓ Download
For new users or important, irreversible actions
Typical use cases
Toolbar
⌕↓⋯
Labeled button
↓Download report
Status cue
✓Synced
Further reading