Icon Action Reference
The following table provides a comprehensive reference for icon usage, including the specific icon, action type, typical use cases, user experience expectations, and contextual behavior.
| Icon | Button Example | Action Type | Typical Use | Feels Like | Contextual Behavior |
|---|---|---|---|---|---|
arrow-left | Go Back | Return to previous screen or section | Navigating backward | Stays on current page; changes view/state | |
arrow-right | Go Forward | Move to next screen or step | Progressing forward | Stays on current page; changes view/state | |
chevron-down | Expand Section | Reveal dropdown, accordion, or collapsible UI | Unfolding | Toggles visibility within the current page | |
chevron-up | Collapse Section | Hide dropdown or expanded UI | Folding up | Toggles visibility within the current page | |
chevron-left | Scroll Left | Horizontal carousel or pagination | Shifting left | Moves view within current content area | |
chevron-right | Scroll Right | Horizontal carousel or pagination | Shifting right | Moves view within current content area | |
external-link | External Link | Open a different website or external app | Leaving current experience | Opens new tab/window; leaves the current domain | |
refresh-ccw | Refresh / Retry | Retry a failed action or reload content | Resetting / trying again | Reloads content inside the current page context | |
arrow-up-right | Open Modal / Context | Launch modal, preview, or expanded panel | Branching out / exploring | Stays on current page; opens overlay or modal | |
arrow-down-right | Drill Down | Navigate to details or sub-process | Descending into specifics | Replaces or updates current page view | |
download | Download | Save file (PDF, CSV, etc.) | Taking something offline | Triggers download; stays on current page | |
plus-circle | Add Item | Create new item, open creation modal | Creating / initiating | Stays on current page; may open modal or form | |
trash-2 | Delete Item | Permanently remove an item or record | Destructive action | Removes item from system; may show confirmation dialog | |
square-pen | Edit Item | Modify existing content or settings | Making changes | Opens edit form or inline editing mode |