Form Error Message Writing Template
Map real form failures to clear affected fields, safe recovery instructions and appropriate feedback without exposing internal details.
When to use this template
Use this when a signup or request form displays a generic failure that leaves the visitor unsure what to correct or retry.
Choose another approach when: You want to disclose private account existence, blame the person for a service failure, or tell users to resubmit when duplicate processing could occur.
Gather these inputs
- The actual supported error conditions and processing states.
- Safe recovery actions verified by the implementation owner.
- The field labels and feedback presentation used by the real form.
Copy and adapt the template
Edit the text below and copy it into your own document. Edits stay in this browser field and are not submitted or saved by this page.
Worked example
Illustrative example, not a Crany customer result. Replace every example detail with facts you can verify.
A fictional waitlist form rejects an address missing its domain. The message identifies the email field and explains the required correction. A different case occurs when the service times out after submission: the team cannot safely claim the request failed or tell the visitor to submit repeatedly until it understands the processing state. The matrix keeps validation and service errors separate. Technical logs remain private, while the user sees a useful next action that has actually been verified.
How to use it
- List actual failures and distinguish field correction from service or unknown-state problems.
- Write concise recovery guidance using the real field label and safe processing behavior.
- Reproduce each case safely and verify feedback placement with the implementation owner.
Check before using it
- The message describes the actual condition without speculation.
- Recovery instructions do not create duplicate or unsafe submissions.
- Sensitive implementation or account details stay out of public feedback.
What to measure
Track whether people can recover from the tested failures and which messages still need investigation. Copy review does not establish that error announcements, focus handling or every failure path are accessible.
Research and sources
W3C supports understandable feedback tied to affected controls and correction steps. This original matrix adds product-processing context; it is not a security or accessibility certification.
- W3C WAI: User Notification — checked 2026-10-23. Clear success and error feedback, identification of affected controls and understandable recovery instructions.
- W3C WAI: Form Instructions — checked 2026-10-23. Clear required/optional input, formats and contextual help associated with form controls.
About Crany
Crany is an AI marketing co-founder in development for software founders and vibe coders, designed to strategize, execute approved marketing and improve based on results. This free resource is usable independently of the product. Join the public waitlist.