pattern-library checked

Atlassian Design System: Modal dialog

Frames modal dialogs as layered content that requires user interaction above the page.

Open source

Pattern Decisions This Source Supports

Pattern Supported decision Required contract Claim note
Modal dialog Choose a modal dialog for a short contained task that must temporarily suspend interaction with the page behind it. Opening the modal moves focus to the best starting element inside the dialog, not to the dimmed page. Frames modal dialogs as layered content requiring user interaction above the page.
Modal for nonblocking content Flag this anti-pattern when content can be read later, ignored safely, dismissed without consequence, or shown near its object without blocking the rest of the page. Users can continue the primary task while reading or ignoring nonblocking information. Frames modal dialogs as layered content requiring user interaction above the page.

Evidence Role

This source is treated as pattern-library evidence. Use it to validate the decision rules above, not as a visual style reference.

Publisher: Atlassian. Last checked: .