Contextual actions

Added · Seed

… the actor has designated a target through a selection or by pointing at an element: a text span, a document block, an object on a canvas, or rows in a list. Keeping the controls for that target in a distant toolbar mixes relevant actions with inapplicable ones and pulls focus away from the work, while a command menu requires recalling an action by name rather than acting directly on the target.

Problem

When the actions for a selected item sit in a distant toolbar or a searchable command list, the actor has to move focus away from the target, scan past controls that do not apply, or recall a command by name. In nested content—such as a word inside a paragraph inside a section—an action can also modify a larger container than the selection without making that scope clear.

Contextual actions appear through several mechanisms: a floating toolbar on text selection, a popover menu on right-click or long press, hover actions on a list row or card, a menu attached to a block handle, or an action bar that appears when list items are selected. Each mechanism trades discoverability against visual interference. A floating toolbar that appears on every text selection keeps actions close at hand, but covers adjacent lines and interrupts actors who highlight text to read or copy it. A right-click or long-press menu avoids visual clutter until requested, but hides available actions behind an unlabelled gesture. Hover toolbars reveal actions without persistent chrome, though they have no direct equivalent on touch screens.

Scope ambiguity is the primary failure mode when content is nested. A text selection sits inside a block, and some operations apply to the inline span (bold, link, rewrite sentence) while others apply to the containing block (convert to heading, move, comment on block). Mixing both levels in a single menu without distinguishing their reach causes actions to modify more than the actor selected. Multi-block selections compound the ambiguity when the same operation, such as an AI revision, can run either on the highlighted span or on the surrounding blocks. When scope is explicit, selecting a target first and invoking a reusable prompt action from a toolbar is faster and requires shorter instructions than describing the target in chat (Masson et al., 2024).

Solution

Surface the actions that apply to the selected or targeted item directly beside it, and omit actions that do not apply. Let the selection define the scope of every action. When an action operates on a larger container than the selection—such as the whole block or row—preview that container boundary before execution and name the target in the action’s label. Keep the contextual surface limited to high-frequency actions, leaving the full command set to a searchable command menu.

Continuation

Relevant actions appear adjacent to the target with their scope bound to the selection, so the actor designates the object first and chooses the operation second. On selected text, the same contextual toolbar can host prestructured formatting, commenting, and instructed revision. It is part of a data view, and of a block-based editor, where it serves both the span and the block. Filtering the menu to valid actions omits irrelevant controls rather than showing them disabled, following unavailable actions. Displaying keyboard shortcuts alongside menu items helps actors learn direct key combinations and bypass the menu on repeat use…

All connections
Enables
Data view, block-based editor — It is part of a data view, and of a block-based editor, where it serves both the span and the block.
Hosts
Instructed revision, commenting, prestructured formatting — On selected text, the same contextual toolbar can host prestructured formatting, commenting, and instructed revision.
Deletion
Tag
Comparing
Complements
Unavailable actions — Filtering the menu to valid actions omits irrelevant controls rather than showing them disabled, following unavailable actions.
Keyboard shortcuts — Displaying keyboard shortcuts alongside menu items helps actors learn direct key combinations and bypass the menu on repeat use
View as context
Alternatives
Command menu — invoking an action from a selected target rather than searching for it by name
Drag and drop — choosing an action for the selected item rather than carrying it to a destination that stands for the change
Preceded by
Selection — selection designates the target that contextual actions operate on
Related components
  • Bubble menu — floating toolbar anchored to a text selection for inline formatting, commenting, and revision actions
  • Context menu — menu opened on right-click or long press at the pointer target
  • Action bar — bar that appears when one or more items in a list or collection are selected

Resources & references