1. Docs
  2. Get started
  3. Quick Start
  4. Troubleshooting

Troubleshooting

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

5 min read Updated CustomersAdmins

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#

“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 with a company domain.
“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 (see roles). If nobody knows the account, write to support.
“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.
“The email or password you entered is incorrect”Login
Check
Caps Lock; whether your company uses Active Directory (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#

“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 and choose the project whose name ends in (Sample). What it contains: The sample project.
“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”.
“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, test case, requirement, pipeline or user.
Fix
Reuse existing items, or ask an Admin to extend the licence. An Admin sees the licence and its usage limits in Company SettingsBilling (License Details). Deleting items does not help.
“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.
Fix
An Admin renews the licence under Company Settings › Billing. Your data is kept and becomes editable again.

Extension and recording#

“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.
  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.
“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 that has a URL, or add the URL in Project PanelStart Page URLs.

Runs and agents#

“The following agent(s) are currently offline” / agent dot is greyAgent
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).
  2. It uses this host’s API key (each host has its own).
  3. The machine can reach SmartestQA; a proxy or firewall may block the WebSocket connection.
Fix
Start the agent and wait for green (when an agent counts as online). For web tests that can reach your app from the internet, choose Run on Server instead. Desktop tests have no server option.
“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. If it persists, write to support with the time of the attempt.
My test ran but there is nothing in ReportReport
Why
It was a Dry Run. Dry runs show a live log only.
Fix
Add the test to a pipeline in Schedule and run that.

Access#

“No Project Access” or “Please contact your administrator to access this feature.”Roles
Why
You have the User role and were not given this project, or the screen is admin-only.
Fix
Ask your company admin to grant project access or do the admin task. Who can do what: Roles.

What causes problems later#

Do

Don’t

Didn’t find your answer?Write to support with your project name and what you see on screen.

info@smartestqa.ai