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

Gen AI

  • AI tools
    1
  • LLMs.txt files

  • Foundation
    3
  • Visual affordance
  • Colors
  • Iconography

  • Patterns
    15
  • Pattern abstraction
  • Generative AI chat
  • Ingress
  • Generative AI output label
  • Generative AI loading states
  • Follow-up questions
  • User authorized actions
  • Variables
  • Shortcut menus
  • Response regeneration
  • Artifact previews
  • Conversational history
  • Support prompts
  • Thinking

  • Components
    6
  1. Cloudscape Design System
    • Gen AI: Foundation
    • Visual affordance
    1. Cloudscape Design System
    2. Gen AI: Foundation
    3. Visual affordance

    Visual affordance

    Styling and visual properties that can help users identify generative AI powered features across any experience.

    On this page

    1. Need for a generative AI visual affordance
    2. Foundational elements
    3. Key concepts
    4. General guidelines
    5. Related pages
    6. Generative AI patterns

    About this page

    Published: November 17, 2023

    Did this page help you?

    Your feedback helps us improve our documentation.
    Provide additional feedback

    Need for a generative AI visual affordance

    Build familiarity

    As generative AI rapidly evolves, it is crucial to support customers in identifying and understanding how to interact with this new technology. Providing a unique visual affordance to distinguish generative AI-powered features helps build familiarity, and strengthens users’ mental models as generative AI offerings continue to grow. 

    Cultivate trust

    Generative AI is a powerful tool, but is still limited by build and training data. generative AI may produce inaccurate or partial responses, and we need to help users set reasonable expectations around use of this tool. We can achieve this in part by providing a distinct visual affordance to generative AI outputs. By distinguishing generative AI artifacts from those of a human, we can help allows users to identify when generative AI intervenes in a given task flow and increase their confidence in using generative AI. 

    Consistent end user experience

    While a growing number of teams are working to integrate generative AI into their experiences, visual consistency is important to ensure a consistent end user experience. A shared visual affordance to represent generative AI across the user journey reduces cognitive load, eases the learning curve, and ultimately improves task efficiency for our users.

    Foundational elements

    The visual affordance for generative AI revolves around 2 foundational visual components.

    Colors

    Color is one of the most powerful drivers of visual consistency. A shared color set across generative AI experiences helps users identify their context faster and build trust more easily.

    Iconography

    Iconography integrates seamlessly across different components in an interface to inform users about new or enhanced generative AI features, signal generative AI output, or to represent a specific entity.

    Key concepts

    The visual affordance related to generative AI in a given experience will varies according to the following concepts.

    Stage in generative AI experience 

    Visual affordance should be applied such that it helps users orient with the stage they are at in a given generative AI experience.

    The ingress point needs to be visually distinct and prominent, to differentiate itself from other UI elements on the page. To add visual emphasis, styling may include iconography, and motion. Generative AI action triggers and prompts to provide user input should use a low-medium level of affordance as they need to integrate with other elements across the page. Visual styling may include iconography.

    When a model is processing the input sent by a user, a medium-high level of visual emphasis is recommended. As it involves loading and interstitial states, visual styling may include color gradients and motion to help convey the progress of an action.

    Visual affordance will be is used to indicate that the model has produced a result, helping increase user confidence. A low-medium level of styling is recommended to not interrupt the user flow, this includes the use of icon next to the text label that indicates the output.

    Degree of generative AI intervention

    Visual affordance should convey the degree of intervention that generative AI plays in a certain process. A prominent visual treatment helps communicate to users that they’re about to start a process where they don’t have full control. On the other hand, a lighter visual treatment integrates the action more seamlessly with others.

    Context and hierarchy

    The context in which generative AI is present plays an important role in the level of hierarchy that the visual affordance requires.  

    When the entire product is a generative AI offering, including specific visual affordance in low level UI elements is not optimal, as it can overwhelm users. The visual schema needs to be defined on a product or application level instead. For these use cases, we recommend replacing aspects from the visual foundation with generative AI-specific styling. When a generative AI offering is contained to a page, visual affordance is applied at the page level, such as through page-level actions. When a generative AI feature pertains to a particular section on a given page, we recommend localized styling.

    General guidelines

    Do

    • Rely on the fundamental visual components when adding generative AI visual affordance to elements in your application. Providing a consistent visual language helps reduce cognitive load.
    • Align to established patterns and strengthen visual conventions. If an element already exists in other applications and has a particular visual affordance, align to it and contribute to establishing the mental model.

    Don't

    • Don’t overwhelm users by applying excessive visual affordance. Decide the appropriate hierarchy based on the context, users’ stage of experience, and the degree of generative AI intervention in a given action.
    • Don’t interrupt the user flow to introduce visual affordance (for example, introducing a loading state that’s not needed for the sake of adding an animated gradient).
    • Don’t introduce visual affordance that impacts user performance.

    Related pages

    About generative AI

    Understand more about generative AI, and our key principles behind its creation in Cloudscape.

    Pattern abstraction

    An abstraction of generative AI patterns.

    Generative AI patterns

    Generative AI chat

    Generative AI chat is a conversation between a user and a generative AI assistant.

    Ingress

    An interactive element such as a button that lets users engage a generative AI-powered feature.

    Generative AI output label

    A short label to indicate that an output is produced by generative AI.

    Did this page help you?

    Your feedback helps us improve our documentation.
    Provide additional feedback
    • About
    • Connect
    • Privacy 
    • Site terms 
    • © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved.
    Made with ❤️ at AWS