Using Test Emails

Learn how to use and review the Rainforest QA email system.


When creating tests, you can send an email to an address. This feature is useful for use cases such as authorization and confirmation. Moreover, you can also use the detailed information Rainforest captures to help with debugging.

Test Sending an Email from Your App to the User

Use {{random.inbox}} with {{}} to test email verification.

{{}}. This placeholder gives each of your tests a globally unique email address. It’s great for testing signup flows. Any email sent to {{}} appears in its corresponding {{random.inbox}}.

{{random.inbox}}. This is a temporary, web-based email inbox similar to Mailinator.


A {{random.inbox}} example.

Review delivery by performing the following steps:

  1. Navigate to {{random.inbox}}.
  2. The page displays a list of all emails sent to the address in the last 30 days.
  3. Choose the email you want to investigate by clicking the Open Email button.
  4. The page displays detailed information, including timestamped events.

Email delivery details and timestamps.


Emails older than 30 days are automatically deleted from the inbox.

Use the placeholder {{}} wherever a step is required to enter an email address in your app. Then, when you want to check whether the email was successfully sent, create a step to navigate to {{random.inbox}} and confirm the email is there.

You can write steps to clear the inbox. To do so:

  1. Navigate to {{random.inbox}}
  2. Click the Clear Inbox button

Customizing Rainforest Email Addresses

Some testing scenarios might require the use of emails that you create, this is possible using our inbox. To create a customized email please ensure it uses the below guidelines

  • The email must end in
  • The email can not be over 254 characters.
  • The email can only contain the following: Letters A-Z, Numbers 0-9, and Special Characters . -_


Customized Email Example

If you are testing a new login feature and want specific emails to track the flow: [email protected]

Create Multiple Unique Email Addresses

Some workflows require testing multiple email addresses in a test. For example, {{}}, which is typically used to provide a test with a randomly generated email, provides a single email. However, for workflows requiring 2 or more unique email addresses, you can create a second email by combining two or more placeholders.



Combine random.firstname, random.password, and “” to produce

Result:[email protected]

Instruct the test to access the inbox using the URL, which in this case is:

Append characters to create additional random emails.

For example, {random.firstname}{random.password}[email protected] and {random.firstname}{random.password}[email protected].

Result: and, respectively.

For the inboxes use{{random.firstname}}{{random.password}}1 and{{random.firstname}}{{random.password}}2.

Instruct the test to access the inboxes using the URLs, which in these examples will be: and

If you have any questions, reach out to us at [email protected].