Quick Start Guide

Learn how to run Rainforest tests and integrate them into your QA workflow.

Welcome to Rainforest. In this article, we show you how to:

  • Add your site to Rainforest
  • Write your first test
  • Set up a testing schedule
  • Integrate results notifications and bug reporting into your QA workflow

Adding Your Site URL or Mobile App to Rainforest

  1. Click the Settings icon (gear) in the navigation bar.
  2. On the Settings page, select Sites.
  3. Click “+ New Web Site.”
  4. Key in the Site Name, such as “Google.”
  5. Key in the site URL, such as https://google.com/.
  6. Click the Create button.

Multiple Environments

If you plan to include other environments such as Staging and Production, click the dropdown next to the site and add the URLs, such as https://staging.google.com/ and https://dev.google.com/. For more information, see Setting Up Sites and Environments.

Note: Site security is essential. To ensure testers can reach your site, see Accessing Test Environments for tips on setting up your testing environment.

For information on how to test a native mobile application, see Configuring Mobile Apps for Testing. If you don't have access to this feature and would like it, contact the Rainforest Support team.

Writing and Running Your First Test

Rainforest makes it possible to create functional, UI-level tests in a matter of minutes. You can run them on demand and in parallel using our Automation Service or Tester Community. And no code is required.

There are two test types: Visual Editor and Plain-Text Editor. You don’t need to pick just one. Many customers use a combination to maximize their testing capabilities. Let’s start by writing a Visual Editor test.

Visual Editor Tests

You write Visual Editor tests in a structured, no-code language. The test steps are defined in terms of actions (Click, Type, and Hover) and targets (screenshots of UI elements such as buttons and fields).

When writing your test steps, use actions and targets. Then, use Preview Action to replay the actions on the virtual machine to ensure they work before publishing and running the test.

Unlike Plain-Text Editor tests, you can run Visual Editor tests using our Automation Service for faster execution. If you require human feedback, run the tests using our Tester Community, a global crowd of thousands of human testers.

Selecting our Automation Service allows you to run fast, automated web browser execution of your tests. Or you can choose to use our Tester Community.


Selecting the run method.

Plain-Text Editor Tests

You write Plain-Text Editor tests using an action/question format. Tests are executed in parallel by two or more testers from our Tester Community. Following are the high-level steps covered in the next video.

  1. Write an example sign-up test for Amazon.
    Insert test data, screenshots and downloadable files, and embed tests for easy test-writing and maintenance.
  2. Preview your test and verify that it works before publishing it.
  3. Run the test on the browser and environment of your choice.

Checking Your Automation Service Test Results

Navigate to the Results page to view the test results. If your test passed, you’re all set. If not, determine where the failure occurred, make the correction, and run again.

Investigating Failed Tests Run by the Tester Community


Categorizing a failure.

Setting Up Testing Schedules and Organizing Test Suites

Let’s set up a testing schedule. In this section, we create a run group called “Smoke Tests” and set an automatic testing schedule. Tests or test groups can also be kicked off programmatically using our CLI. Moreover, you can integrate with CircleCI.

  1. Click the Tests page icon (paper) in the navigation bar.
  2. Select Run Groups from the sub-menu.
  3. Create a Run Group.
  4. Set up a testing schedule. (Optional)
  5. Return to the Tests page.

When you’re ready, select any number of tests by clicking the checkboxes, then clicking the Add to Run Group icon (clock).

We have many other features to help you organize your test suite, including Tags, Features, and Saved Filters. To learn more about test suite organization, check out this video or see Organizing Tests by Run Group.

Integrating Rainforest into the Workflow

  • Results Notifications
    Send notifications via email or use our Slack Integration to feed results into a Slack channel. This is a great way to keep your team engaged. If you don’t use Slack, set up email results notifications on the Integrations page. You can also integrate with Microsoft Teams.
  • Issue Reporting
    Set up Jira Integration to create tickets from test failures with a single click.

6. Optimizing and Expanding

So far, we’ve done the following:

  • Designed and built our initial test suite
  • Set a test execution cadence
  • Developed workflows for results triaging and failure recovery

But there’s still more we can do.

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