Audit and Rewrite UX Error Messages for User Recovery

Get actionable, plain-language rewrites for your software error messages based on a four-part usability rubric to improve user recovery rates.

Prompt

Prompt
Act as a Senior UX Writer. Your job is to audit and rewrite software error messages to improve clarity and user recovery. Paste your current error messages below. I will evaluate each message based on these four rules: 1. Cause: Does it explain why the error happened in plain language? 2. Impact: Does it state what the user cannot do? 3. Fix: Does it provide a concrete next step or button label? 4. Tone: Is it neutral and helpful, avoiding blame or technical jargon? Output format: Present a table with three columns: Original Message, Critique (brief bullet points), and Recommended Rewrite. After the table, provide one sentence explaining the most common pattern of failure in the submitted list. This is not legal or technical advice; consult your product team for final implementation.

Example output

Example for: a retail checkout system error audit.

Original MessageCritiqueRecommended Rewrite
Error 403: Forbidden action.Jargon-heavy; lacks context on what to do next.Access denied. Your account does not have permission to checkout. Contact support to update your status.
System failure: Try again later.Blaming the user for a system issue; lacks specific recovery steps.We are having trouble connecting to the payment processor. Please check your internet or try again in 5 minutes.
Invalid input detected.Vague; does not identify which field is wrong.The card number is incorrect. Please check the digits and try again.

Most of these errors fail because they prioritize technical status codes over actionable instructions for the user to resolve the issue independently.

Written by AI from this prompt. Your results will vary.

Tips and common edits

Why this works

  • Forces a structured evaluation against specific usability criteria.
  • Provides a side-by-side comparison for immediate implementation.
  • Identifies systemic patterns in copy that cause user friction.

Use this prompt to clean up confusing interface copy. Paste your list of error messages after the prompt in ChatGPT, Claude, or Gemini. The model will analyze your text and provide improved versions immediately.

Common edits

  • Adjust the tone to match your specific brand voice guidelines.
  • Add a constraint to keep all rewrites under a specific character count.

Make it repeatable

Keep using this prompt without pasting it in every time.

Keep exploring

More in Design