Patterns
Proven answers to what people need to do, grouped by the job: ask for information, find, understand, act, get started, pay, recover, and more. Each pattern says when to use it, when not to, and the parts it is built from, marked Built or Planned so you always know what is real today.
Showing 157 of 157 patterns.
Ask for 20
Getting one kind of information right.
NamesAsk for a person's name in a way that fits every culture.2 of 3 parts built
- Use it when
- Use one full name field unless you truly need parts. Ask what they like to be called if you will greet them.
- Not when
- Do not force first and last name, ban accents, or cap length short.
- Text field · Built
- Hint and error text · Built
- Form layout · Planned
Email addressesCollect an email that works the first time.All parts built
- Use it when
- Use type email, turn off autocorrect, and say why you need it.
- Not when
- Do not ask people to type it twice. Show it back on check your answers instead.
Phone numbersCollect a phone number in any format people type.All parts built
- Use it when
- Accept spaces, dashes, and country codes. Say whether you will call or text.
- Not when
- Do not split the number into boxes or reject valid formats.
AddressesGet a postal address people can enter fast.1 of 3 parts built
- Use it when
- Offer address lookup with a manual fallback. Use separate lines only where the country needs them.
- Not when
- Do not assume one country's format or make every line required.
- Text field · Built
- Autocomplete · Planned
- Form layout · Planned
DatesAsk for a date people already know.1 of 2 parts built
- Use it when
- Use day, month, year fields for known dates like a birthday.
- Not when
- Do not use a calendar picker for dates people know by heart.
- Date input · Planned
- Hint and error text · Built
Choosing a dateHelp people pick a date they are planning.Guidance only
- Use it when
- Use a calendar for bookings and nearby dates, with typed entry too.
- Not when
- Do not hide the typed option, and never block keyboard use.
- Date picker · Planned
- Date input · Planned
TimesAsk for a time without confusion over AM and PM.All parts built
- Use it when
- Accept many formats and show the time zone when it matters.
- Not when
- Do not use long scroll wheels on desktop.
PasswordsLet people create a strong password they can manage.1 of 2 parts built
- Use it when
- Allow paste and password managers, show the password on request, and explain rules up front.
- Not when
- Do not cap length, ban paste, or force odd character rules.
- Password field · Planned
- Hint and error text · Built
One time codesConfirm a code sent by text or email.1 of 2 parts built
- Use it when
- Use one field with autocomplete one-time-code and a resend link with a wait time.
- Not when
- Do not split the code into boxes that break paste.
- One time code input · Planned
- Text field · Built
Payment card detailsTake card details safely and quickly.1 of 2 parts built
- Use it when
- Use the payment provider's hosted fields, support autofill, and show accepted cards in words.
- Not when
- Do not build your own card storage or ask for card type when the number tells you.
- Text field · Built
- Form layout · Planned
Bank detailsCollect account details for payments in or out.All parts built
- Use it when
- Check numbers as they are typed and show the bank name back.
- Not when
- Do not ask for bank details before people know why.
Amounts of moneyAsk for a money amount clearly.All parts built
- Use it when
- Show the currency beside the field and accept commas and decimals.
- Not when
- Do not use a number spinner for money.
Numbers and quantitiesAsk for a count or quantity.1 of 2 parts built
- Use it when
- Use a text field with numeric input mode, or a stepper for small counts.
- Not when
- Do not use type number for things like card or phone numbers.
- Text field · Built
- Quantity stepper · Planned
Yes or no questionsAsk a simple question with two answers.Guidance only
- Use it when
- Use two radios with a clear question as the legend.
- Not when
- Do not use one checkbox for a question that needs an answer.
- Radio group · Planned
- Form layout · Planned
Choosing from optionsLet people pick one or many from a list.1 of 4 parts built
- Use it when
- Radios for one of a few, checkboxes for many, a select or autocomplete for long lists.
- Not when
- Do not hide five or fewer options inside a dropdown.
- Radio group · Planned
- Checkbox · Planned
- Select · Built
- Autocomplete · Planned
Uploading filesLet people add files and documents.1 of 2 parts built
- Use it when
- Say which types and sizes work, show progress, and allow removing a file.
- Not when
- Do not start upload without feedback or lose files on an error.
- File upload · Planned
- Progress · Built
Sex and genderAsk about sex or gender respectfully, only when needed.1 of 2 parts built
- Use it when
- Explain why you ask, offer a prefer not to say, and keep sex and gender separate.
- Not when
- Do not ask at all if you do not need it.
- Radio group · Planned
- Hint and error text · Built
Equality informationCollect optional data for fairness monitoring.Guidance only
- Use it when
- Make every question optional and say how the data is used.
- Not when
- Do not mix it into required steps.
- Radio group · Planned
- Checkbox · Planned
- Form layout · Planned
Contact preferencesLet people choose how and how often you reach them.1 of 2 parts built
- Use it when
- Offer channels and frequency, unchecked by default.
- Not when
- Do not pre-tick marketing consent.
- Checkbox · Planned
- Switch · Built
Smart prefill and defaultsFill what you already know so people type less.1 of 2 parts built
- Use it when
- Prefill from earlier answers and let people change it.
- Not when
- Do not prefill choices that cost money or share data.
- Text field · Built
- Form layout · Planned
Help people to: Find 12
BreadcrumbsShow where a page sits and step back up.Guidance only
- Use it when
- Use on deep sites with clear levels.
- Not when
- Do not use as the only navigation or on flat sites.
- Breadcrumbs · Planned
TabsSwitch between views of the same thing.All parts built
- Use it when
- Use for two to seven peer views.
- Not when
- Do not use tabs for steps in a process.
SearchFind a known thing fast.Guidance only
- Use it when
- Put search where people expect it and keep the words they typed.
- Not when
- Do not clear the box after searching.
- Search field · Planned
AutocompleteSuggest matches as people type.Guidance only
- Use it when
- Use for long lists people know the name of.
- Not when
- Do not auto-pick a match without the person choosing.
- Autocomplete · Planned
Search resultsShow what matched and let people narrow it.1 of 3 parts built
- Use it when
- Show the count, the query, and why each result matched.
- Not when
- Do not show an empty page without help.
- List · Planned
- Filter bar · Planned
- Empty state · Built
FiltersNarrow a long list by facts.1 of 3 parts built
- Use it when
- Show active filters as removable tags with a clear all.
- Not when
- Do not reload the page for every tick on slow connections.
- Filter bar · Planned
- Tag · Planned
- Badge · Built
SortChange the order of a list.1 of 2 parts built
- Use it when
- Name the order in words, like newest first.
- Not when
- Do not use arrows alone.
- Sort control · Planned
- Select · Built
Saved viewsReturn to a filtered view later.1 of 2 parts built
- Use it when
- Let people name and share a view.
- Not when
- Do not save views silently.
- Tabs · Built
- Filter bar · Planned
Skip links and landmarksLet keyboard and screen reader users jump to content.Guidance only
- Use it when
- Add a skip to content link and real landmarks on every page.
- Not when
- Do not hide the skip link when it has focus.
- Navigation bar · Planned
Help people to: Understand 16
TablesCompare many records by the same facts.Guidance only
- Use it when
- Use real table markup, align numbers right, and keep headers visible.
- Not when
- Do not use a table for layout.
- Index table · Planned
Index table with filtersManage a long list of records.Guidance only
- Use it when
- Pair a table with search, filters, sort, and bulk actions.
- Not when
- Do not load thousands of rows at once.
- Index table · Planned
- Filter bar · Planned
- Bulk action bar · Planned
- Pagination · Planned
ListsShow a set of items to scan.Guidance only
- Use it when
- Keep each item to one line of key facts and one action.
- Not when
- Do not cram tables into list rows.
- List · Planned
CardsShow a group of items with an image or summary.All parts built
- Use it when
- Use when items differ and a picture helps.
- Not when
- Do not use cards for data people compare line by line.
DashboardsShow how things are going at a glance.2 of 3 parts built
- Use it when
- Lead with three to five numbers that drive a decision.
- Not when
- Do not fill the screen with every metric you have.
- Metrics card · Built
- Chart · Planned
- Card · Built
Key numbersShow one number, its change, and its period.All parts built
- Use it when
- Say the change in words and with an arrow.
- Not when
- Do not use red and green alone.
ChartsShow a trend or comparison.Guidance only
- Use it when
- Pick the chart from the question and label lines directly.
- Not when
- Do not use pie charts for many parts.
- Chart · Planned
PaginationBreak long results into pages.Guidance only
- Use it when
- Show where people are and allow jumping.
- Not when
- Do not use infinite scroll where people need the footer.
- Pagination · Planned
Load moreAdd more results on request.1 of 2 parts built
- Use it when
- Use for browsing feeds and keep the scroll place.
- Not when
- Do not use when people need to find an item again.
- Button · Built
- List · Planned
Progressive disclosureShow the basics and reveal detail on request.Guidance only
- Use it when
- Hide advanced options behind a clear label.
- Not when
- Do not hide what most people need.
- Accordion · Planned
AccordionsStack sections people open one by one.Guidance only
- Use it when
- Use for many sections people only need some of.
- Not when
- Do not hide a single short answer inside one.
- Accordion · Planned
Details pageShow everything about one record.1 of 3 parts built
- Use it when
- Lead with the name, status, and main action.
- Not when
- Do not bury the main action at the bottom.
- Page header · Planned
- Summary list · Planned
- Button · Built
Images and videoShow media that loads well and reads for all.Guidance only
- Use it when
- Give alt text, captions, and reserve space to stop jumps.
- Not when
- Do not autoplay sound.
- Media frame · Planned
GalleriesBrowse many images.1 of 2 parts built
- Use it when
- Use a grid with a full view that works by keyboard and swipe.
- Not when
- Do not trap focus in the full view.
- Gallery · Planned
- Modal · Built
Frequently asked questionsAnswer common questions.Guidance only
- Use it when
- Group by topic and link from where the question comes up.
- Not when
- Do not use an FAQ to patch unclear pages.
- Accordion · Planned
TooltipsExplain a control in a few words.Guidance only
- Use it when
- Use for icon labels and short hints, shown on hover and focus.
- Not when
- Do not put needed information or links in a tooltip.
- Tooltip · Planned
Help people to: Act 16
FormsCollect information in a way people can finish.2 of 3 parts built
- Use it when
- One question per idea, labels above fields, and errors in words.
- Not when
- Do not use placeholder text as the label.
- Form layout · Planned
- Text field · Built
- Hint and error text · Built
One thing per pageSplit long forms into simple pages.Guidance only
- Use it when
- Use for long or high stakes forms.
- Not when
- Do not split a short form for no reason.
- Form layout · Planned
- Step indicator · Planned
Multi step tasksGuide people through a long task.1 of 3 parts built
- Use it when
- Show steps, allow going back, and save progress.
- Not when
- Do not lose answers on back.
- Step indicator · Planned
- Form layout · Planned
- Progress · Built
Task listLet people finish a long task in any order.All parts built
- Use it when
- Show each section with its status in words.
- Not when
- Do not hide which parts are left.
Check your answersLet people review before they submit.1 of 2 parts built
- Use it when
- List every answer with a change link.
- Not when
- Do not skip it for anything that costs money or is final.
- Summary list · Planned
- Button · Built
ValidationTell people what to fix and how.1 of 2 parts built
- Use it when
- Check on submit, show an error summary, and link to each field.
- Not when
- Do not validate while people are still typing.
- Error summary · Planned
- Hint and error text · Built
Inline editingChange a value where it is shown.Guidance only
- Use it when
- Use for quick single value changes with save and cancel.
- Not when
- Do not use for edits that need checking first.
- Inline edit · Planned
AutosaveSave work without a button.1 of 2 parts built
- Use it when
- Show saved status in words and when it last saved.
- Not when
- Do not autosave things that send or charge.
- Badge · Built
- Toast · Planned
UndoLet people take back an action.1 of 2 parts built
- Use it when
- Offer undo after deletes and bulk changes.
- Not when
- Do not use a confirm box where undo would do.
- Toast · Planned
- Button · Built
Confirm a risky actionStop and check before something cannot be undone.All parts built
- Use it when
- Name the thing and the result in the button, like Delete project.
- Not when
- Do not confirm everyday actions.
Drag and dropReorder or move items directly.Guidance only
- Use it when
- Always offer a keyboard and button way too.
- Not when
- Do not make drag the only way.
- Drag handle · Planned
- List · Planned
Bulk actionsAct on many items at once.Guidance only
- Use it when
- Show how many are selected and what will happen.
- Not when
- Do not select across pages without saying so.
- Bulk action bar · Planned
- Checkbox · Planned
Keyboard shortcutsSpeed up frequent actions.1 of 2 parts built
- Use it when
- Show them in menus and a help panel, and allow turning them off.
- Not when
- Do not take over keys people need for typing or assistive tech.
- Keyboard key · Planned
- Modal · Built
Create newStart a new item fast.1 of 2 parts built
- Use it when
- Ask only what you need to start and fill the rest later.
- Not when
- Do not make people fill everything up front.
- Button · Built
- Form layout · Planned
Upload and importBring in files or data in bulk.Guidance only
- Use it when
- Preview what will import and report problems row by row.
- Not when
- Do not import silently with errors.
- File upload · Planned
- Index table · Planned
Booking and schedulingChoose a time that works for both sides.1 of 3 parts built
- Use it when
- Show times in the person's time zone and confirm by email.
- Not when
- Do not show taken times as choosable.
- Date picker · Planned
- List · Planned
- Button · Built
Help people to: Get started 10
WelcomeGreet new people and point to the first step.All parts built
- Use it when
- Keep it to one screen with one main action.
- Not when
- Do not stack welcome, tour, and survey together.
Setup guideShow what to do to get going and how far along people are.All parts built
- Use it when
- Use a short checklist with progress and one next action.
- Not when
- Do not list more than about seven steps.
Guided tourShow the main parts of a new tool.Guidance only
- Use it when
- Keep it short, skippable, and replayable.
- Not when
- Do not block the product until the tour ends.
- Coachmark · Planned
CoachmarksPoint out one new thing in place.Guidance only
- Use it when
- Show one at a time when it is relevant.
- Not when
- Do not cover what people are trying to use.
- Coachmark · Planned
Sample dataLet people try a tool before adding their own data.All parts built
- Use it when
- Mark sample items clearly and make them easy to clear.
- Not when
- Do not mix sample data with real data.
First use empty stateTurn a blank screen into a starting point.All parts built
- Use it when
- Say what will appear here and offer the first action.
- Not when
- Do not leave a blank page.
Start from a templateSkip the blank page with a starting point.All parts built
- Use it when
- Offer a few strong templates and a blank option.
- Not when
- Do not force a template.
What is newTell people about changes.All parts built
- Use it when
- Show it once, near the change, with a link to more.
- Not when
- Do not interrupt work with a full screen.
Learn as you goTeach features when people need them.1 of 2 parts built
- Use it when
- Trigger help from what people do.
- Not when
- Do not front load every feature.
- Coachmark · Planned
- Callout · Built
Bring your dataImport from another tool to start fast.1 of 2 parts built
- Use it when
- Name the tools you support and show what comes across.
- Not when
- Do not promise a perfect import.
- Account connection · Built
- File upload · Planned
Help people to: Identity 13
Sign upCreate an account with little effort.1 of 3 parts built
- Use it when
- Ask only for what you need now and allow password managers.
- Not when
- Do not ask for profile details before people see value.
- Form layout · Planned
- Text field · Built
- Password field · Planned
Sign inGet back in quickly and safely.Guidance only
- Use it when
- Support password managers, passkeys, and show the password on request.
- Not when
- Do not block paste or say which part was wrong.
- Form layout · Planned
- Password field · Planned
PasskeysSign in without a password.All parts built
- Use it when
- Offer passkeys alongside a fallback.
- Not when
- Do not remove every fallback.
Magic linksSign in from an email link.All parts built
- Use it when
- Say where the link went and how long it lasts.
- Not when
- Do not use when people sign in on a shared device often.
Sign in with another accountUse an existing account to sign in.All parts built
- Use it when
- Say what data is shared and keep an email option.
- Not when
- Do not offer only one provider.
Two step checkAdd a second check at sign in.1 of 2 parts built
- Use it when
- Offer an authenticator app and backup codes.
- Not when
- Do not use text messages as the only option for high risk accounts.
- One time code input · Planned
- Text field · Built
Guest accessLet people act without an account.All parts built
- Use it when
- Use for checkout and one time tasks, offering an account after.
- Not when
- Do not force sign up to buy.
Reset passwordGet back in after forgetting.1 of 2 parts built
- Use it when
- Send a link, say it was sent even if the email is unknown.
- Not when
- Do not reveal whether an account exists.
- Form layout · Planned
- Callout · Built
Connected accountsLink other services.All parts built
- Use it when
- Say what access each connection has and allow disconnecting.
- Not when
- Do not hide what a connection can see.
InvitesBring others into a space.1 of 2 parts built
- Use it when
- Show who invited them and what they can do.
- Not when
- Do not send reminders without limit.
- Form layout · Planned
- Avatar · Built
Roles and permissionsControl who can do what.1 of 2 parts built
- Use it when
- Name roles by what they can do and show it in a table.
- Not when
- Do not invent many near identical roles.
- Index table · Planned
- Select · Built
ProfileLet people see and change their details.1 of 3 parts built
- Use it when
- Group details and allow editing in place.
- Not when
- Do not make every field public by default.
- Summary list · Planned
- Inline edit · Planned
- Avatar · Built
Sign out and sessionsEnd a session and see where you are signed in.1 of 2 parts built
- Use it when
- List devices with a sign out of all.
- Not when
- Do not hide sign out.
- List · Planned
- Button · Built
Help people to: Transact 14
Product pageHelp people decide to buy.1 of 4 parts built
- Use it when
- Lead with photo, price, options, and add to cart, then details.
- Not when
- Do not hide the price or shipping cost.
- Product card · Planned
- Media frame · Planned
- Gallery · Planned
- Button · Built
Product listingBrowse many products.Guidance only
- Use it when
- Show price, photo, and key option on each card, with filters.
- Not when
- Do not hide sold out items without saying so.
- Product card · Planned
- Filter bar · Planned
CartReview what you are buying.Guidance only
- Use it when
- Show items, quantity, price, and the total with costs before checkout.
- Not when
- Do not add items people did not choose.
- Cart line · Planned
- Quantity stepper · Planned
- Order summary · Planned
CheckoutPay and finish an order.Guidance only
- Use it when
- Allow guest checkout, show total cost early, and keep steps few.
- Not when
- Do not reveal fees at the last step.
- Form layout · Planned
- Order summary · Planned
- Step indicator · Planned
Order confirmationShow the order went through.Guidance only
- Use it when
- Give an order number, what happens next, and send a receipt.
- Not when
- Do not end on an upsell before the confirmation.
- Confirmation panel · Planned
- Summary list · Planned
Pricing tableCompare plans at a glance.All parts built
- Use it when
- Same parts in the same order per plan, with the recommended plan named in words.
- Not when
- Do not use fake scarcity or hide the cheaper plan.
Coupons and discountsApply a code.All parts built
- Use it when
- Keep the field small and confirm the saving.
- Not when
- Do not make the code field so big it sends people to search for codes.
Free trialsTry before paying.All parts built
- Use it when
- Say when the trial ends, remind before charging, and allow cancel any time.
- Not when
- Do not charge without a clear reminder.
PaywallExplain what paying unlocks.All parts built
- Use it when
- Show what is included and keep a way back.
- Not when
- Do not block content people already had.
Usage metersShow how much of a limit is used.2 of 3 parts built
- Use it when
- Use numbers and a bar, and warn before the limit.
- Not when
- Do not cut people off without warning.
- Usage meter · Planned
- Progress · Built
- Callout · Built
Manage subscriptionChange or pause a plan.1 of 2 parts built
- Use it when
- Show the current plan, next charge, and changes plainly.
- Not when
- Do not hide the plan page.
- Summary list · Planned
- Button · Built
CancellationLeave a plan easily.1 of 2 parts built
- Use it when
- Make cancel as easy as sign up, with one optional reason.
- Not when
- Do not use guilt, mazes, or phone only cancellation.
- Button · Built
- Form layout · Planned
Invoices and receiptsFind and download past payments.1 of 2 parts built
- Use it when
- List by date with amount and status in words.
- Not when
- Do not email only.
- Index table · Planned
- Badge · Built
Returns and refundsSend something back.Guidance only
- Use it when
- Show the policy up front and track the return.
- Not when
- Do not hide the return link.
- Form layout · Planned
- Step indicator · Planned
Help people to: Collaborate 8
Activity feedSee what changed and who changed it.1 of 2 parts built
- Use it when
- Group by time and allow filtering.
- Not when
- Do not show every tiny event.
- Activity feed · Planned
- Avatar · Built
CommentsDiscuss work in place.1 of 2 parts built
- Use it when
- Thread replies and allow resolving.
- Not when
- Do not lose comments when content changes.
- Comment · Planned
- Avatar · Built
MentionsBring someone into a conversation.Guidance only
- Use it when
- Suggest people as you type the at sign.
- Not when
- Do not notify people who cannot see the item.
- Autocomplete · Planned
- Comment · Planned
ReactionsRespond without writing.1 of 2 parts built
- Use it when
- Keep a small set and show who reacted.
- Not when
- Do not replace real replies.
- Button · Built
- Popover · Planned
SharingGive others access.2 of 3 parts built
- Use it when
- Show who has access and what they can do.
- Not when
- Do not default to public.
- Share panel · Planned
- Select · Built
- Avatar · Built
PresenceSee who else is here.All parts built
- Use it when
- Show avatars of people viewing now.
- Not when
- Do not track presence without saying so.
Version historySee and restore older versions.1 of 2 parts built
- Use it when
- List versions by time and person, with restore.
- Not when
- Do not overwrite without history.
- List · Planned
- Button · Built
ApprovalsAsk for and give sign off.All parts built
- Use it when
- Show who must approve and status in words.
- Not when
- Do not let approvals stall without reminders.
Help people to: Stay informed 10
NotificationsTell people what needs them.1 of 2 parts built
- Use it when
- Group, let people control them, and mark read.
- Not when
- Do not notify for everything.
- List · Planned
- Badge · Built
ToastsConfirm a small action briefly.Guidance only
- Use it when
- Use for short confirmations with optional undo.
- Not when
- Do not put errors or needed info in a toast that disappears.
- Toast · Planned
BannersTell everyone about something that affects the whole page.Guidance only
- Use it when
- Use for site wide notices, dismissible when safe.
- Not when
- Do not stack many banners.
- Banner · Planned
CalloutsHighlight a message in the page.All parts built
- Use it when
- Match tone to meaning with icon and title, not color alone.
- Not when
- Do not use for every paragraph.
StatusShow the state of something.All parts built
- Use it when
- Use a badge with a word, like Paid or Overdue.
- Not when
- Do not use colored dots alone.
ProgressShow how long something will take.1 of 2 parts built
- Use it when
- Show a bar for known lengths and steps in words.
- Not when
- Do not show a bar that does not move.
- Progress · Built
- Loader · Planned
ConfirmationsShow a task finished.1 of 2 parts built
- Use it when
- Say what happened and what comes next.
- Not when
- Do not leave people unsure it worked.
- Confirmation panel · Planned
- Callout · Built
Messages and inboxRead and reply to messages.Guidance only
- Use it when
- Show unread state in words and keep threads together.
- Not when
- Do not mix messages and notifications.
- List · Planned
- Chat thread · Planned
Transactional emailSend receipts and alerts people trust.All parts built
- Use it when
- Plain words, one action, and the same brand as the product.
- Not when
- Do not hide unsubscribe on emails that need one.
Live updatesShow changes as they happen.Guidance only
- Use it when
- Announce changes politely to screen readers and allow pausing.
- Not when
- Do not move content under the cursor.
- List · Planned
- Toast · Planned
Help people to: Recover 10
Empty statesExplain why there is nothing and what to do.All parts built
- Use it when
- Use for first use, no results, and cleared lists, each with its own words.
- Not when
- Do not show a blank area.
No resultsHelp when a search finds nothing.1 of 2 parts built
- Use it when
- Repeat the query and suggest fixes.
- Not when
- Do not blame the person.
- Empty state · Built
- Search field · Planned
Error messagesSay what went wrong and how to fix it.2 of 3 parts built
- Use it when
- Plain words, no codes alone, and keep what people typed.
- Not when
- Do not say Something went wrong and stop there.
- Error summary · Planned
- Hint and error text · Built
- Callout · Built
LoadingShow something is happening.Guidance only
- Use it when
- Use skeletons for layout and a loader for short waits.
- Not when
- Do not show a loader for under a second.
- Skeleton · Planned
- Loader · Planned
OfflineKeep working without a connection.1 of 2 parts built
- Use it when
- Say you are offline and what still works, and sync later.
- Not when
- Do not lose work when the connection drops.
- Banner · Planned
- Badge · Built
Session timeoutsWarn before signing people out.All parts built
- Use it when
- Warn with time to extend and keep their work.
- Not when
- Do not time out mid form without warning.
RetryTry again after a failure.All parts built
- Use it when
- Offer a retry button and say if it is safe to retry.
- Not when
- Do not retry payments without saying so.
Restore deleted itemsGet something back after deleting.1 of 3 parts built
- Use it when
- Keep a trash for a set time.
- Not when
- Do not delete forever without warning.
- List · Planned
- Button · Built
- Toast · Planned
Edit conflictsHandle two people changing the same thing.All parts built
- Use it when
- Show both versions and let people choose.
- Not when
- Do not overwrite silently.
Account recoveryGet back into a locked account.1 of 2 parts built
- Use it when
- Offer backup codes and a human route.
- Not when
- Do not make recovery weaker than sign in.
- Form layout · Planned
- Callout · Built
Help people to: Configure 9
SettingsChange how a product works.1 of 3 parts built
- Use it when
- Group by topic with search, and save clearly.
- Not when
- Do not scatter settings across the product.
- Side navigation · Planned
- Form layout · Planned
- Switch · Built
PreferencesSet personal choices like language and units.1 of 2 parts built
- Use it when
- Default from the device and allow changing.
- Not when
- Do not guess language from location alone.
- Select · Built
- Radio group · Planned
Privacy controlsSee and control your data.2 of 3 parts built
- Use it when
- Explain each choice in plain words and allow export and delete.
- Not when
- Do not bury privacy in legal text.
- Switch · Built
- Summary list · Planned
- Button · Built
Cookie consentAsk before using non-essential cookies.1 of 2 parts built
- Use it when
- Equal accept and reject buttons, with details.
- Not when
- Do not pre-tick or hide reject.
- Consent panel · Planned
- Button · Built
Accessibility optionsAdjust motion, contrast, and text size.1 of 2 parts built
- Use it when
- Follow device settings first and allow overrides.
- Not when
- Do not ignore reduce motion.
- Switch · Built
- Radio group · Planned
Light and dark themeChoose a color theme.All parts built
- Use it when
- Follow the device and allow a manual choice.
- Not when
- Do not flash the wrong theme on load.
IntegrationsConnect other tools.All parts built
- Use it when
- List what each can access and its status in words.
- Not when
- Do not hide disconnect.
Export your dataTake your data with you.All parts built
- Use it when
- Offer common formats and say when it is ready.
- Not when
- Do not make export harder than import.
Delete accountLeave and remove data.All parts built
- Use it when
- Say what is deleted and when, and confirm by name.
- Not when
- Do not hide it or keep data without saying.
Help people to: Work with AI 10
Suggested promptsHelp people start with AI.All parts built
- Use it when
- Show a few real examples tied to their work.
- Not when
- Do not show generic prompts that do not fit.
Prompt boxAsk the AI for something.Guidance only
- Use it when
- Large box, attach context, and show what the AI can see.
- Not when
- Do not hide limits until people hit them.
- Prompt box · Planned
Context setupGive the AI the right background.Guidance only
- Use it when
- Show what files and data are included and allow removing them.
- Not when
- Do not include private data without saying.
- File upload · Planned
- Tag · Planned
Streaming answersShow an answer as it is written.1 of 2 parts built
- Use it when
- Allow stopping and keep the page from jumping.
- Not when
- Do not move the scroll without consent.
- Chat thread · Planned
- Button · Built
CitationsShow where an answer came from.Guidance only
- Use it when
- Link each claim to its source.
- Not when
- Do not show sources that were not used.
- Citation · Planned
Review and refineChange or redo an AI answer.1 of 2 parts built
- Use it when
- Allow edit, retry, and compare.
- Not when
- Do not apply AI changes without review.
- Chat thread · Planned
- Button · Built
Honest AI disclosureSay clearly what is made by AI.All parts built
- Use it when
- Label AI content and say it can be wrong.
- Not when
- Do not pass AI work off as human.
AI actions with approvalLet AI do things with a person in charge.2 of 3 parts built
- Use it when
- Show the plan and ask before anything that changes data, sends, or spends.
- Not when
- Do not let AI act on its own where it matters.
- Modal · Built
- Summary list · Planned
- Button · Built
Feedback on answersRate an answer so it improves.All parts built
- Use it when
- Keep it one tap with optional words.
- Not when
- Do not nag after every answer.
When AI is unsureShow uncertainty honestly.All parts built
- Use it when
- Say when the AI does not know and offer a next step.
- Not when
- Do not invent confident answers.
Page types 9
Whole pages people meet at key moments. These lead to Templates.
Confirmation pageEnd a task with certainty.Guidance only
- Use it when
- Say it worked, give a reference, and say what happens next.
- Not when
- Do not end on a blank thank you.
- Confirmation panel · Planned
- Summary list · Planned
Interruption pageStop people to tell them something important before they go on.1 of 2 parts built
- Use it when
- Use rarely, for things that change what they do next.
- Not when
- Do not use for marketing.
- Page header · Planned
- Button · Built
Page not foundHelp people who hit a missing page.1 of 2 parts built
- Use it when
- Say the page is not here, and offer search and main links.
- Not when
- Do not use jokes that hide the help.
- Empty state · Built
- Search field · Planned
Cookies pageExplain cookies and let people change their choice.Guidance only
- Use it when
- List each cookie by purpose with a save button.
- Not when
- Do not make it read only.
- Consent panel · Planned
- Index table · Planned
Start pageExplain a service before people begin.1 of 2 parts built
- Use it when
- Say what it does, what people need, and how long it takes.
- Not when
- Do not bury the start button.
- Page header · Planned
- Button · Built
Dashboard homeA home that shows what needs attention.2 of 3 parts built
- Use it when
- Lead with tasks and key numbers.
- Not when
- Do not make it a wall of widgets.
- Metrics card · Built
- Setup guide · Built
- List · Planned
Settings pageOne home for every setting.Guidance only
- Use it when
- Side navigation by topic with search.
- Not when
- Do not put settings in modals.
- Side navigation · Planned
- Form layout · Planned
Pricing pageExplain plans and costs fully.1 of 3 parts built
- Use it when
- Plans, a full comparison, and answers to common questions.
- Not when
- Do not hide prices behind contact us unless truly custom.
- Pricing table · Built
- Index table · Planned
- Accordion · Planned
Ethics appendix: persuasive patterns
Scarcity, countdowns, social proof, streaks, and other patterns that change behavior. They are kept apart so you can recognize them and use them only when they are true and good for the person, never to trick anyone.