Skip to content
Help Center
Browse documentation

Create your first project

A project is one web app, identified by its URL. Add a name and URL, choose whether to record test runs, and TestOptim takes you to the Knowledge page.

Updated 5 min read

To create a project in TestOptim, select Projects, then New Project, and enter a name and your app's URL. A project is one web app: its pages, test cases, test runs and issues all belong to it.

Before you start

  • You must be the organization Owner or an Admin. Other roles can't create projects.
  • Your plan has a project limit (2 on Solo). See The project limit.
  • Have the URL of a staging or test copy of your app ready, not your production site. See the warning below.
  • TestOptim's browsers run in the cloud, so they can only open your app directly if it is on the public internet. For an app on your own network, such as an internal hostname, a private IP address or localhost, turn on Private network when you create the project and connect the TestOptim CLI. See Test apps on a private network with the TestOptim CLI.

Warning

Don't use your production site or a real admin login. The agent clicks buttons and submits forms, so it can create, change or delete data on the site you give it. While exploring it skips actions that look destructive, but test runs follow each test's steps, and it can't tell real data from test data, so pointing it at your live site can cause real data loss. The New project form shows the same warning.

Create the project

  1. In the sidebar, select Projects, then New Project. If you just started a trial, you can also select Create a project in the Solo is live dialog.

  2. Enter a Project Name. It can be up to 100 characters.

  3. Enter the Website URL. A bare host such as staging.myapp.com is fine, and TestOptim adds https:// for you. If you typed your URL into the box on the TestOptim home page before signing up, it's already filled in here.

  4. Optionally, add a Description.

    The New project form with the name, URL and description filled in, and the recording and Cloudflare toggles
    The New project form

  5. Choose your options:

  6. Select Create project, or Create and connect CLI if you turned on Private network.

If the URL isn't valid, TestOptim shows an error and doesn't create the project. Check the address and try again.

The New project form with a bad URL and an error message at the bottom right
A URL that isn't valid is rejected

Warning

The URL can't be changed after the project is created. The knowledge base, test cases and issues all describe that specific app. To test a different URL, create a new project.

What happens next

TestOptim opens the project's Knowledge page. Nothing starts automatically: no exploration, no test generation and no test run. Select Start exploration when you're ready. See Explore your app.

The Knowledge page of a new project, with the Start exploration button
A new project's Knowledge page

The project limit

Your plan limits how many projects you can have. Archived projects don't count when you create a new one.

When you've reached the limit, the New project page shows a Project limit reached card instead of the form, with an Upgrade Plan button.

The Project limit reached card saying You have reached your Projects limit (2/2), with an Upgrade Plan button
The Project limit reached card

To make room, archive a project you no longer need, or upgrade your plan. See You have reached your plan limit.

On a free trial: a site that another account already tests

A free trial only covers sites that no other TestOptim account is testing. If another account already has a project for the same site, Create project is refused with:

"site is already being tested from another TestOptim account, so it can't be added on a free trial. Subscribe to test it here, or ask that account's owner to invite you."

Subscribe to a paid plan to test the site from your account, or ask the other account's Owner to invite you. They need Startup or above to invite you, because Solo's one seat is the Owner's. The rule looks at the site's hostname, so a different subdomain counts as a different site. It doesn't apply to IP addresses, internal hostnames without a public domain ending such as app.corp, or reserved test domains such as example.com.