AddressLab Guide
Temporary Email Testing: Form Validation vs Delivery QA
An email-shaped test value and a working QA mailbox solve different problems. AddressLab creates a non-deliverable .test value for form, storage, display, and export checks. It does not create an inbox or receive messages.
Start by naming the test you are running
Email testing is often treated as one task, but it contains at least two layers. The first layer checks whether a form accepts an email address, saves it, displays it without clipping, and includes it in an API payload or export. The second layer checks whether a message is queued, delivered, rendered, and linked correctly. A format-only value is enough for the first layer; the second requires a mailbox your team controls.
What AddressLab generates
The email field generated with an address record uses the reserved .test top-level domain. That domain is intended for testing and is not a public mail destination. The value can be copied into a staging form, saved with a synthetic customer record, displayed in a profile card, and exported to CSV or JSON without exposing a real personal address.
It has no inbox, password, login, message list, verification-link access, or password-recovery capability. This boundary is deliberate: a test fixture should not silently become an account that stores private messages.
Workflow for email-field validation
- Generate one address record and copy its
.testemail value. - Submit the value through the signup, checkout, or profile form under test.
- Confirm that client-side and server-side validators accept valid syntax without accepting malformed variants.
- Check database storage, profile display, mobile wrapping, API payloads, CSV output, and JSON output.
- Delete the synthetic record after the test if your staging environment does not reset automatically.
Workflow for delivery and notification testing
When the acceptance criterion says “the user receives a message,” replace the .test value with a dedicated mailbox controlled by your QA team or an email-testing provider designed for staging environments. Record the application event ID, send time, recipient, expected template, delivery time, and link destination. This evidence separates product defects from mail-queue, DNS, reputation, and provider delays.
Use separate aliases or inboxes for signup confirmation, password recovery, receipts, and notification regression tests. Do not use a personal mailbox or production customer data.
A small test matrix
- Syntax and required-field rules: use an AddressLab
.testvalue. - Responsive layout and saved-profile display: use an AddressLab
.testvalue. - CSV, JSON, CRM, and fixture imports: use an AddressLab
.testvalue. - Verification links, receipts, and password recovery: use a controlled QA mailbox.
- Production account recovery or sensitive messages: use an approved production mailbox and production security controls.
Common reporting mistake
Do not report “email delivery is broken” after sending to a reserved .test address. That address is not expected to receive mail. First confirm which layer failed: field validation, record creation, event creation, queue processing, provider delivery, template rendering, or link handling. The expected result for each layer should be written into the test case before execution.
Use email fields with address test data
For forms that collect both contact and location fields, open the temporary email testing guide and generate an address record. Use the same synthetic identity for signup form validation, checkout field checks, account profiles, saved-address displays, screenshots, and exports. Switch to a controlled QA mailbox only for the delivery portion of the test.
Responsible use
Generated identities are for development, QA, prototypes, training, and demos. Do not use them for real account recovery, spam registration, harassment, fraud, impersonation, platform-rule bypassing, or handling sensitive information.
Related tools
- Temporary Email for Testing for non-deliverable email-field fixtures and QA boundaries.
- US Address Generator for structured address records with a
.testemail field. - Generated addresses for form testing for broader workflow guidance.
- Disclaimer for generated-data limitations.