---
title: "Troubleshooting"
section: "Quick Start"
description: "Fixes for the messages new SmartestQA users see: sign-up and login, projects and licence, the extension, agents and runs, and access rights."
url: https://docs.smartestqa.ai/en/quick-start-troubleshooting.html
audience: [customer, admin]
updated: 2026-11-07
keywords: "error message problem fix corporate email link expired limit reached license expired extension not detected agent offline report empty no project access"
---
# Quick Start: Troubleshooting

Find the message you see. Each entry says why it happens, what to check and how to fix it.

## In short

**On this page you can**

- Fix sign-up and login messages, such as a rejected email or an expired link.
- Solve project and licence errors, such as a reached limit or an expired licence.
- Get the extension detected and a recording started with a start page URL.
- Bring an offline agent back, find a missing report, or get project access.
- See what to do and avoid so the problems do not come back.

**How to use it**

1. Search the page for the exact message you see, or scan the section headings.
2. Open the entry and read Why to confirm it matches your case.
3. Work through Check in order, then apply Fix .
4. Still failing? Write to support with the message and the time it happened.

## Sign-up and login

### Problem: “Please use a corporate email address” _(Sign-up)_

- **Why:** The address is on a free mail provider (gmail.com, outlook.com, hotmail.com, yahoo.com, icloud.com, live.com, msn.com, aol.com, yandex, mail.ru, gmx.com, web.de, qq.com, 163.com, 126.com, naver.com, proton).
- **Fix:** [Sign up](https://docs.smartestqa.ai/en/quick-start-account.html#step-1) with a company domain.

### Problem: “This email address / company name / phone number is already in use” _(Sign-up)_

- **Why:** Each of these must be unique across SmartestQA. Often a colleague already signed the company up.
- **Check:** Ask around, then try **Forgot Password?** with the address.
- **Fix:** Ask the existing admin to [invite you as a user](https://docs.smartestqa.ai/en/company-settings-users.html#add-user) (see [roles](https://docs.smartestqa.ai/en/company-settings-roles.html)). If nobody knows the account, write to support.

### Problem: “Your Password Has Not Been Set Yet” _(Login)_

- **Why:** You tried to log in before using the password link from the sign-up email.
- **Fix:** A new link has just been sent to the address shown. Use the newest email; older links stop working.

### Problem: “Link Has Expired” or “Invalid or expired token” _(Login)_

- **Why:** Password links are valid for 24 hours and only the newest one works.
- **Fix:** On the login page click **Forgot Password?**, enter your email and click **Send**.

### Problem: “The email or password you entered is incorrect” _(Login)_

- **Check:** Caps Lock; whether your company uses [Active Directory](https://docs.smartestqa.ai/en/company-settings-active-directory.html#sign-in) (then the field asks for the AD user name).
- **Fix:** Reset with **Forgot Password?**. “No users registered with this email were found.” means the address has no account.

## Projects and licence

### Problem: “Sample project has already been created for this company.” _(Project)_

- **Why:** The sample is created automatically at the first password setup, and only once per company.
- **Fix:** Open the [project picker](https://docs.smartestqa.ai/en/quick-start-project.html#create) and choose the project whose name ends in `(Sample)`. What it contains: [The sample project](https://docs.smartestqa.ai/en/quick-start-project.html#sample-project).

### Problem: “This project name has already been used in this company.” _(Project)_

- **Fix:** Project names are unique per company. Add the platform or team, for example “Customer Portal – Web”.

### Problem: “Company license limit has been reached” _(Licence)_

- **Why:** Your company’s licence can limit how many projects, test cases, requirements, pipelines and users you create and how many pipeline runs you start, and one of these counters has reached its limit. Counters count creations, so deleted items still count.
- **Check:** Which create failed: [project](https://docs.smartestqa.ai/en/quick-start-project.html#create), [test case](https://docs.smartestqa.ai/en/automate-test-cases.html#create-test-case), [requirement](https://docs.smartestqa.ai/en/analyze-requirements.html#create-main), [pipeline](https://docs.smartestqa.ai/en/schedule-create.html#create) or [user](https://docs.smartestqa.ai/en/company-settings-users.html#add-user).
- **Fix:** Reuse existing items, or ask an Admin to extend the licence. An Admin sees the licence and its usage limits in **Company Settings** › [**Billing**](https://docs.smartestqa.ai/en/company-settings-billing.html) ([License Details](https://docs.smartestqa.ai/en/company-settings-billing.html#licence-details)). Deleting items does not help.

### Problem: “Your license has expired. Please renew to continue using all features.” _(Licence)_

- **Why:** The trial ended, or a paid renewal failed and the account is [suspended](https://docs.smartestqa.ai/en/company-settings-billing.html#licence-status).
- **Fix:** An Admin renews the licence under [Company Settings › Billing](https://docs.smartestqa.ai/en/company-settings-billing.html). Your data is kept and becomes editable again.

## Extension and recording

### Problem: “Smartest extension not found” / “Browser extension still not detected” _(Extension)_

- **Why:** The extension is missing or disabled, or the SmartestQA tab was open before you installed it.
- **Check:** 1. Chrome menu › Extensions: SmartestQA is listed and switched on. If not, [install it](https://docs.smartestqa.ai/en/quick-start-connect.html#install-extension).
  2. You are in Chrome or Edge, not another browser.
  3. Company policy is not blocking extensions (ask IT).
- **Fix:** Press `F5` on the SmartestQA tab and try again. If it still fails, remove and re-add the extension, then refresh.

### Problem: “Please select a Start Page URL.” / “No URL configured for environment” _(Recording)_

- **Why:** No start page is selected, or the selected one has no address for the chosen environment.
- **Fix:** Pick a start page and an [environment](https://docs.smartestqa.ai/en/concepts.html#environments) that has a URL, or [add the URL](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url) in **Project Panel** › [**Start Page URLs**](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url).

## Runs and agents

### Problem: “The following agent(s) are currently offline” / agent dot is grey _(Agent)_

- **Why:** The agent is not running, the computer slept, or no heartbeat arrived for 90 seconds.
- **Check:** 1. The agent program is running on that computer ([Install an agent](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent)).
  2. It uses this [host’s API key](https://docs.smartestqa.ai/en/agent-pool-agents.html#api-key) (each host has its own).
  3. The machine can reach SmartestQA; [a proxy or firewall may block the WebSocket connection](https://docs.smartestqa.ai/en/agent-pool-troubleshooting.html#fix-agent-offline).
- **Fix:** Start the agent and wait for green ([when an agent counts as online](https://docs.smartestqa.ai/en/quick-start-connect.html#agent-online-rule)). For web tests that can reach your app from the internet, choose [**Run on Server**](https://docs.smartestqa.ai/en/quick-start-connect.html#agent) instead. [Desktop tests have no server option](https://docs.smartestqa.ai/en/schedule-where.html#desktop).

### Problem: “The test server is not reachable right now” / “The test server queue is full” _(Run)_

- **Fix:** Try again in a minute, or [run on your agent](https://docs.smartestqa.ai/en/quick-start-connect.html#agent). If it persists, write to support with the time of the attempt.

### Problem: My test ran but there is nothing in Report _(Report)_

- **Why:** It was a [Dry Run](https://docs.smartestqa.ai/en/automate-dry-run.html). Dry runs show a [live log](https://docs.smartestqa.ai/en/automate-dry-run.html#live-log) only.
- **Fix:** [Add the test to a pipeline](https://docs.smartestqa.ai/en/quick-start-first-test.html#step-6) in [Schedule](https://docs.smartestqa.ai/en/schedule.html) and [run that](https://docs.smartestqa.ai/en/schedule-runs.html#run-now).

## Access

### Problem: “No Project Access” or “Please contact your administrator to access this feature.” _(Roles)_

- **Why:** You have the [User role](https://docs.smartestqa.ai/en/company-settings-roles.html#matrix) and were not given this project, or the screen is [admin-only](https://docs.smartestqa.ai/en/company-settings-roles.html#admin-screens).
- **Fix:** Ask your company admin to [grant project access](https://docs.smartestqa.ai/en/company-settings-users.html#project-access) or do the admin task. Who can do what: [Roles](https://docs.smartestqa.ai/en/company-settings-roles.html).

## What causes problems later

#### Do

- Use a [test environment](https://docs.smartestqa.ai/en/concepts.html#environments) and a dedicated test user.
- [Fill DEV and TEST URLs; set a default start page.](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url)
- Keep [one application per project](https://docs.smartestqa.ai/en/quick-start-project.html#project-type).
- Run tests you want to keep through a [pipeline](https://docs.smartestqa.ai/en/schedule-create.html).
- Give each teammate [their own login](https://docs.smartestqa.ai/en/company-settings-users.html#add-user).
- Refresh SmartestQA after [installing the extension](https://docs.smartestqa.ai/en/quick-start-connect.html#install-extension).

#### Don’t

- Delete and recreate items to stay under a licence limit. [Counters do not go down.](https://docs.smartestqa.ai/en/quick-start-troubleshooting.html#fix-limit-reached)
- Record on production or with real customer data.
- Expect [dry runs](https://docs.smartestqa.ai/en/automate-dry-run.html) in [Report](https://docs.smartestqa.ai/en/report.html).
- Mix web and mobile screens in one project.
- Put a laptop agent behind a [pipeline that runs at night](https://docs.smartestqa.ai/en/schedule-timing.html). Use an [always-on machine](https://docs.smartestqa.ai/en/agent-pool-agents.html#new-agent).
- Share the admin account with a colleague or consultant. Create a user.
