> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Popover

> Popovers, which are commonly triggered by Buttons, appear contextually near the trigger element allowing users to interact more efficiently with the UI. They are often used for lightweight interactions or providing contextual information in forms.

## Popover

<Badge color="blue">v1.0.0</Badge> | [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/primitives-popover--docs)

### When to use

* For lightweight, contextual content or actions: Use Popovers to show information or actions directly related to a specific trigger (Button, icon, text).
* When you want to keep users in context: Popovers are non-blocking and allow users to stay on the same screen without major interruptions.
* To display additional details or previews on demand: For example, previewing user profile details on hover or click.
* When you need more space than a tooltip, but less than a Dialog: Popovers can hold controls like Buttons, which can provide additional links to more information or confirmative actions like a soft (non-destructive) delete.

### When to use something else

* Brief, passive hints on hover/focus with no controls inside: use [Tooltip](/aura-design-system/primitives/tooltip).
* Full attention, blocking flow, or critical decisions: use [Dialog](/aura-design-system/primitives/dialog) / [Alert dialog](/aura-design-system/primitives/alert-dialog) or a dedicated page.
* Choosing from a list of commands or values: use [Menu](/aura-design-system/primitives/menu) or [Select](/aura-design-system/primitives/select), not a generic [Popover](/aura-design-system/primitives/popover).

### Dos and don'ts

* Do anchor the Popover clearly to a trigger element.
* Do use a Popover for secondary or optional tasks as they should enhance the primary workflow, not interrupt it.
* Do be mindful of screen boundaries and reposition the Popover if necessary as it should be fully visible when triggered without the user having to scroll to see it.
* Don't block essential content behind the Popover, or make sure the user can move the Popover to see the content.
* Don't allow more than one Popover to be displayed at a time.

### Behavior

* Non-modal overlay anchored to a trigger; dismisses on outside click and Escape unless the design requires persistent multi-control content.
* Repositions to remain in the viewport; may allow drag in implementations that support it—don’t obscure essential content without a way to reveal it.

### Often used with

* [Button](/aura-design-system/primitives/button) or subtle text trigger; compact forms ([Input](/aura-design-system/primitives/input), small [Button](/aura-design-system/primitives/button)); not a substitute for [Menu](/aura-design-system/primitives/menu) command lists.