Welcome to Rainforest QA! In a few simple steps (and about 20 minutes) we'll show you how to add your app to Rainforest, write your first few tests, set up testing schedules, and integrate results notifications and bug reporting into your workflow.

1. Add your app URL and/or mobile app to Rainforest

  1. Go to the Settings > Sites Page
  2. Click to "+ New Web Site", name it ('Google' for example), and enter the default site URL, like https://google.com. When you go to create tests, you'll be able to select this URL as a Test Starting URL.
  3. [Optional] If you plan to test on multiple environments, click the dropdown, and update the URLs to point to the environment(s) you may want to test on, such as https://staging.google.com or https://dev.google.com.

If you're a video person, watch our tutorial below:

Note: If your app is behind security layers, check out Accessing Test Environments for common access methods, like whitelisting IPs.

To test a native mobile app, check out Setting up your mobile apps for testing with Rainforest. If you don't have access to this feature but would like it, let us know!

2. Write and run your first test

First, a quick overview: Rainforest Regression Testing allows you to write functional, UI-level tests in a matter of minutes, and run them on-demand and in parallel by our Tester Community, a global crowd of thousands of human testers, and/or our Automation bots, with just a click of a button. No technical expertise required!

We have two test types, but there's no need to pick just one - our most successful customers use a combination of both. To go get started, let's write one of each kind of test.

Plain English Test (Crowd testing)

Plain English tests are written in action-question format, and when executed, they're run in parallel by 3+ testers from our Tester Community, a global crowd of thousands of human testers.

In the video below, see how to:

  1. Write an example sign-up test for Amazon test: insert step variables, screenshots/downloadable files, and embed tests for easy test-writing and maintenance
  2. Preview your test to run through it yourself, and verify it works before Publishing it
  3. Run it on the browser(s) and against the environment of your choice

Rainforest Automation Test (Automated Testing)

What is it? Tests are written in a structured, no-code automation language. Define your test steps in terms of actions and targets. Actions are what you're telling the automation to do (like paste, click, fill, drag) and the target is a UI element, like a button or field.

In the video below, we write a simple Automation test together and learn how to:
1. Load the VM, which you will use to take screenshots of your "targets" (UI elements)

2. Define the test steps - the "actions" and "targets"

3. Use "Live Replay" to replay the actions against the VM, just to make sure they work before Publishing and Running the test

Unlike our Plain English tests (above) these can be run against our Automation, for faster/cheaper execution. Or, if human feedback is important to you, they can be run by our Tester Community.

We've written our first test! Now, let's run it. See the gif below - we can choose "Automation" to run the test against our automation bot, for fast/cheap execution. Or we can choose "Tester Community" to run the test against our Tester Community.

3. Check your test results

Go to https://app.rainforestqa.com/runs to see the results of the test you've run.
If your test passes, great! If not, don't worry. It's normal to need to make tweaks, especially when you're learning the ropes.

How to investigate & triage failed tests run by our Tester Community (video below):

How to investigate & triage failed tests run by Automation:

  • First, determine the cause of the failure, by viewing the reproduction video. Check out Interpreting Automation Test Results to learn more.
  • Then, you'll want to categorize your failure. Why? Categorizing failures allows you to add failure notes and/or send the failure to team members to take action on. Failure categories also display in the Dashboard in the form of a to-do list, and you can track your failure reasons over time in your Analytics charts. Categorizing failures is a habit you'll want to get into.

4. Set up automatic testing schedules and organize your suites

First, let's set up a testing schedule: In the gif below, 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 and/or integrated into your CI process.

  1. Go to Tests > Run Groups
  2. Create a Run Group, name it, and set up a testing schedule (optional)
  3. Go to Tests > Tests, select any number of tests, and click the "Add to Run Group" icon

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 features, check out this video.

5. Integrate Rainforest into your workflow

  • Results notifications: Send notifications via email, or use our Slack integration to feed results into a Slack channel - a great way to keep your team engaged. If you don't use Slack, set up email results notifications on the Integrations page.
  • Issue reporting: Set up our JIRA Integration to create tickets from test failures with a single click.

Check out the Integrations section of our Help Center or this Rainforest Integrations Overview video for more info.

6. Optimize and Expand:

Wow, that was fast! Now that we've designed and built our initial test suite, set a test execution cadence, and developed workflows for results triage and failure recovery, where to focus our efforts next?

  • Get additional tests into Rainforest... continue writing tests yourself, or submit text or video outlines to our Test Writing Service and let our trained test authors take on the heavy lifting for you.
  • Want to run tests against your internal team? Check out On-Premise Testing to turn members of your team into your own testing crowd, and aggregate their test results alongside your Rainforest results.
  • Once you have a good level of scripted test case coverage established... introduce regular Exploratory Testing runs to bug-bash new features and/or test the edges around your application, no investment in test case writing needed.
  • If your application processes payments... look into our Virtual Credit Card to test real credit transactions in production.
  • Have a native mobile app you'd like to test? Let us know you'd like access to Native Mobile App testing and our library of iOS and Android mobile VMs, and be sure to check out our Scaling Mobile QA Guide.


Hey, you're learning a new software - it's normal for questions to come up! When they do, know that we're here to support you.

Click the blue chat icon in the Rainforest App or email us at support@rainforestqa.com to get in touch. Happy testing!

Did this answer your question?