Cloudscape Design System
  • Get started
  • Foundation
  • Components
  • Patterns
  • Demos
  • GitHub 
Cloudscape Design System
  • Get started
  • Foundation
  • Components
  • Patterns
  • Demos
  • GitHub 
  • About

Patterns


  • General

    • Actions
      • Global actions
      • In-context actions
    • Announcing new features
    • Announcing beta and preview features
    • Communicating unsaved changes
    • Data visualization
      • Chart metric drill down
    • Density settings
    • Disabled and read-only states
    • Drag-and-drop
    • Errors
      • Error messages
      • Validation
    • Empty states
    • Feedback mechanisms
    • Filtering patterns
      • Saved filter sets
      • Filter persistence in collection views
    • Hero header
    • Help system
    • Image magnifier
    • Loading and refreshing
    • Onboarding
      • Hands-on tutorials
    • Selection in forms
    • Service navigation
      • Side navigation
      • Top navigation
    • Service Dashboard
      • Static dashboard
      • Configurable dashboard
      • Dashboard items
    • Secondary panels
    • Timestamps
    • User feedback

  • Generative AI patterns

    • Pattern abstraction
    • Generative AI chat
    • Ingress
    • Generative AI output label
    • Generative AI loading states
    • Progressive steps

  • Resource management

    • Create resource
      • Multipage create
      • Single page create
      • Sub resource create
    • Delete patterns
      • One-click delete
      • Delete with simple confirmation
      • Delete with additional confirmation
    • Edit resource
      • Page edit
      • Inline edit
      • Attribute editing
    • View resources
      • Table view
      • Card view
      • Split view
      • Table with expandable rows
    • Resource details
      • Details page
      • Details page with tabs
      • Details page as a hub
  1. Cloudscape Design System
    • Patterns
    • Resource management: Delete patterns
    • Delete with additional confirmation
    1. Cloudscape Design System
    2. Patterns
    3. Resource management: Delete patterns
    4. Delete with additional confirmation

    Delete with additional confirmation

    The delete with additional confirmation pattern helps prevent users from performing accidental, high-severity deletions by adding friction during the deletion process.

    Published: September 10, 2020
    View demo

    On this page

    1. Building blocks
    2. General guidelines
    3. Writing guidelines
    4. Accessibility guidelines
    5. Related patterns and components

    Did this page help you?

    Tell us more - optional

    1000 character(s) available. Do not disclose any personal, commercially sensitive, or confidential information.

    Building blocks

    Delete with additional confirmation can be used for single-resource deletion or multi-resource deletion.

    Use delete with additional confirmation for single-resource deletion if the resource cannot be recreated, or if deleting the resource poses a risk of breaking other infrastructure or causing an outage.

    A.
    Modal title

    Use Delete together with the resource type. For example: Delete instance

    B.
    Reassurance

    Make sure the user understands everything that is being deleted, and that the action is irreversible. Use important details associated with the resource being deleted, such as the resource name or other unique identifiers. Use bold font weight to expose the resource identifier. For example: Permanently delete instance CMRVMLFVHDVHU0? You can’t undo this action.

    C.
    Consequences

    State the possible consequences of the action like severity, outcome, and potential cascading effects of the action. This helps the user be aware of the actual impact and scope of the destructive action. Use the warning alert format to present this information. If possible, add an external link to detailed documentation for users to consult.

    D.
    Confirmation text input field

    Provide an additional layer of confirmation for users to validate the deletion. By default, the user should enter word confirm (with no case sensitivity). 

    E.
    Buttons

    Allow users to execute the resource deletion or to exit the delete flow.

    Additional prerequisites - optional

    F.
    Prerequisite actions 

    Give users clear guidance on prerequisites and recommend best practices. For example, prompting users to disable the resource prior to deletion or create a snapshot to help recover from a deletion in the future. Any links leading to additional information on the prerequisites, or to prerequisite actions outside of the modal, should open in a new tab. Use the Box component with the variant property set to "small" to show the approximate deletion time if the deletion is not instantaneous.

    G.
    Confirmation text input field

    If there is a single action that needs to be completed prior to deletion, disable the input field to focus the user's attention on that prerequisite task.

    H.
    Buttons

    If there is a single action that needs to be completed prior to deletion, disable the primary button in order to focus the user's attention on that prerequisite task.

    General guidelines

    Do

    • Inform users about the severity and consequences of the delete action.
    • Give users additional contextual information about the resource being deleted, to adequately inform the deletion.
    • Use delete with additional confirmation only for high severity deletions, such as those that could break running infrastructure, or create an outage. Adding friction to low severity deletions can slow users down and create frustration. For lower priority deletions, use delete with simple confirmation instead.

    Don't

    • Don’t use other patterns (such as popovers or a new page) to add confirmation to a delete action. Always use a modal.

    Writing guidelines

    General writing guidelines

    • Use sentence case, but continue to capitalize proper nouns and brand names correctly in context.

    • Use end punctuation, except in headers and buttons. Don’t use exclamation points.

    • Use present-tense verbs and active voice.

    • Don't use please, thank you, ellipsis (...), ampersand (&), e.g., i.e., or etc. in writing.

    • Avoid directional language.

      • For example: use previous not above, use following not below.

    • Use device-independent language.

      • For example: use choose or select not click.

    Component-specific guidelines

    • Use sentence case. All words are lowercase except the first word in the phrase, proper nouns, acronyms, and service and feature names. Avoid capitalizing feature names unless absolutely necessary, such as an AWS-specific term or concept.

    • Use second person (you, your) when you address the user.

    • Localize the text on the user interface, including the confirmation text.

      • For example: If the interface is in French, all text including the confirmation text to be entered, should be written in French.

    • Use terminal punctuation for all modal text, except for any text in a list format.

    Modal title

    • Use the format: [Delete] [resource type]

      • For example:

        • For a single resource: Delete instance

        • For multiple resources: Delete instances

    Button text

    • For the button that performs the action, use this text: Delete. If your deletion action is called something different, such as Terminate, then use the same verb in the modal title and button.

    • For the button to dismiss the dialog box without completing the action, use this text: Cancel

    Accessibility guidelines

    General accessibility guidelines

    • Follow the guidelines on alternative text and Accessible Rich Internet Applications (ARIA) regions for each component.

    • Make sure to define ARIA labels aligned with the language context of your application.

    • Don't add unnecessary markup for roles and landmarks. Follow the guidelines for each component.

    • Provide keyboard functionality to all available content in a logical and predictable order. The flow of information should make sense.

    Related patterns and components

    Delete patterns

    With delete patterns, users can delete existing resources.

    Delete with simple confirmation

    Provide a layer of confirmation before deleting resources that cannot be easily recreated.

    One-click delete

    With the one-click delete pattern, users can quickly delete low-risk, non-critical resources.

    Modal

    A user interface element subordinate to an application's main window. It prevents interaction with the main page content, but keeps it visible with the modal as a child window in front of it.

    Did this page help you?

    Tell us more - optional

    1000 character(s) available. Do not disclose any personal, commercially sensitive, or confidential information.
    • About
    • Connect
    • Privacy 
    • Site terms 
    • © 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.
    Made with love atAWS