Generate Realistic Email Addresses in Seed Data
Understand how the seed generator creates believable email addresses by combining first names, last names, and popular domains for test data.
Detailed Explanation
How Realistic Emails Are Generated
Email columns are among the most important to get right in seed data. Placeholder values like test@test.com cause problems when testing search, display, and validation logic. The generator builds emails from real-looking components.
Email Construction Algorithm
The generator follows this pattern:
{first_name}.{last_name}{number}@{domain}
- A random first name is selected (e.g., "sarah")
- A random last name is selected (e.g., "martinez")
- A random number between 1 and 99 is appended
- A domain is picked from popular providers
The result might be: sarah.martinez47@gmail.com
Supported Domains
The domain pool includes gmail.com, yahoo.com, outlook.com, hotmail.com, protonmail.com, icloud.com, and others. This variety makes the data look more natural than using a single domain for every row.
Column Name Matching
Any column whose name contains the substring "email" triggers this generator. This includes:
emailuser_emailcontact_emailprimary_emailemail_address
Uniqueness Considerations
While the generator does not strictly enforce uniqueness, the combination of 40 first names, 40 last names, 10 domains, and a random number suffix produces a very large combinatorial space. For seed datasets of up to 1,000 rows, collisions are extremely rare. If your schema has a UNIQUE constraint, you should verify the generated data or reduce the row count.
Testing Email-Dependent Features
Realistic emails let you test email display formatting, contact list sorting, search-by-email, mailto link generation, and Gravatar integration with data that resembles production.
Use Case
Your application displays user emails in profile cards, admin lists, and notification logs. You need seed data where emails look real enough to test UI truncation, display formatting, and search indexing without using actual personal email addresses.