Skip to main content

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.

Page loader

v1.0.0 | View in Storybook

When to use

  • When loading entire pages or the primary content area after a navigation action.
  • When the content load time is noticeable (typically > 1s) and might cause uncertainty without visual feedback.
  • During transitions between major sections of the product where the context completely changes, such as navigating to a new application or page.

When to use something else

  • For small, localized loads in Menu, Button, Card, Data grid cells, or inline lists: use skeleton or inline spinner patterns instead.
  • For background work while the user keeps working: use Progress or a subtle inline status indicator.
  • For imperceptibly fast loads (< ~1s): skip the loader to avoid flicker.
  • For long loads (> ~4s): prefer Progress or explicit completion messaging.

Behavior

  • Covers the targeted region (full page or main pane) until loading finishes; should not steal focus unless paired with a cancelable operation that needs attention.

Often used with

  • Full-page or pane skeleton UI; for indeterminate waits pair messaging with Progress when a % or cancel is available.
Last modified on May 11, 2026