Intelligence Community Design System ICDS Get started Accessibility Styles Components Patterns Community
Show navigation section

AI (Artificial Intelligence)

Introduction

AI can be a powerful tool when used in the right way and at the right moment in a user journey. This guidance explains how AI integrates with core design system components. It focuses on principles, patterns, and content approaches that will stay relevant as AI continues to evolve.

AI principles

Human-centered design should always be the foundation for AI experiences. This means making them helpful, controllable, and reversible while clearly disclosing which content is AI generated and why.

Help users learn how to use AI models effectively and confidently. AI should always provide a clear benefit to the end user, supporting rather than replacing human judgement. Be honest by letting people know when something has been AI processed and keep interactions transparent by showing what’s happening and what options are available.

When to use

When writing AI interactions for buttons and labels, instead of saying “Generating,” be clear and use straightforward verbs like “Process”, “Summarise”, or “Explain” to set accurate expectations.

An AI alert warning “Low stock anticipated,” with a note explaining stock may run out within seven days. Users can act by selecting “Place order” or dismiss with an X icon.
Automated AI alert message with a “Place order” next steps action button.

When not to use

Don't overuse AI components; they should provide a useful indication where needed.

Avoid vague or playful language such as “Let's work some magic,” which can confuse or mislead users.

A password field showing clear guidance before typing: “Use 8+ characters with a number and a capital letter.”
Display simple requirements upfront, keep guidance specific, and visible rather than handling it with AI.
Don't rely on AI for basic guidance as users may be overwhelmed with information too late and all at once.

Usage

AI components should be used consistently with clear progress cues and feedback at each stage, so users understand what's happening and when it's complete.

Colour

The colour purple is associated with AI, which distinguishes it from other colours such as red for errors and green for success

AI icon

The AI icon is a clear, recognisable symbol that helps users identify when AI is in use. Use it consistently across all AI-driven interactions and always pair it with a clear, descriptive label.

Ensure the icon remains accessible and easy to read, especially when displayed at smaller sizes.

A universal AI icon showing the letters “A” and “I” inside a rounded square, displayed in the designated AI brand colour purple. Universal, purple AI icon helps users quickly identify when AI is present.

Components

Alert

Use alert to inform users when AI is present. Alerts give a more prominent indication of AI being used in an interface. They can contain a small message to give more information about the AI being used and anything users should know about using it.

A purple AI alert banner displaying the message “AI processed content, these coffee recipes have been processed by AI.”
AI alert banner and message clearly indicate the displayed output has been generated by AI.

Toast

Toasts are quick, lightweight pop-ups that deliver updates without interrupting the user. They're ideal for brief notifications such as “AI is working” followed by “Done! Click here to undo” or “Approve change.”

Keep them short, clear, and only on-screen for a few seconds while ensuring they are displayed long enough for their content to be read and understood.

An AI toast notification appears below a comment field displaying the message “Increase brewing time to match customer preference,” with an Approve change button beside it.
AI toast notification “Increase brewing time to match customer preference.” Displayed below a comment field with an “Approve change” button.

Badge

Small labels are a simple way to help users quickly identify AI features or highlight when content has been AI-processed. They work well for displaying values or signaling if something is AI processed but should be used sparingly so that their meaning remains clear and significant.

An example showing three AI badge positions: one on a button labelled “Add milk”, another beside a cup icon within a chip labelled “Espresso”, and a third displayed inline on a tab menu labelled “Coffee”, alongside tabs for “Tea” and “Hot chocolate.”
Different AI badge positions in use on a button, next to an icon within a chip component, and inline within a tab menu group.

Accessibility considerations

All AI-related components should be fully accessible and inclusive. Ensure that app errors are properly announced to screen readers and other assistive technologies, and that the AI icon remains legible and accessible at all sizes.

Users should always understand what information the AI can access and have clear control over what they choose to share, such as specific files or folders. Finally, make it easy for users to provide feedback on AI features so experiences can continually improve based on real user insight.

Do

Maintain transparency whenever content or actions are AI-processed so users understand what's happening behind the scenes. Clearly label AI-generated outputs like “AI summary” or “Suggested by AI” to set user expectations and allows users to make informed decisions.

Include an easy way for users to undo AI actions, such as an “Undo” or “Revert changes” button. This helps users stay in control and confidently use AI suggestions.

Ensure all AI features are accessible to everyone. They must work with screen readers, voice control, and keyboard navigation. Any visual cues like the AI icon or colour must always include text alternatives.

Don't

Overload interfaces with AI badges. Use them sparingly and consistently so users can clearly understand when AI is involved without feeling confused or overwhelmed.

Avoid vague or exaggerated language when talking about AI. Be clear and honest about what it does and how it helps, using plain, factual wording to build trust and set realistic expectations.

Rely only on colour or icons to indicate AI features. Always pair them with clear text. The AI colour purple and icon should be supported by labels like “AI-assisted” to ensure meaning and accessibility for users.


Last reviewed 27 November 2025 .
Navigated to AI (Artificial Intelligence) - Intelligence Community Design System