- Docs
- Get started
- Quick Start
- Troubleshooting
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
- Search the page for the exact message you see, or scan the section headings.
- Open the entry and read Why to confirm it matches your case.
- Work through Check in order, then apply Fix.
- 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.
“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.
“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
-
- Chrome menu › Extensions: SmartestQA is listed and switched on. If not, install it.
- You are in Chrome or Edge, not another browser.
- 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
-
- The agent program is running on that computer (Install an agent).
- It uses this host’s API key (each host has its own).
- 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
- Use a test environment and a dedicated test user.
- Fill DEV and TEST URLs; set a default start page.
- Keep one application per project.
- Run tests you want to keep through a pipeline.
- Give each teammate their own login.
- Refresh SmartestQA after installing the extension.
Don’t
- Delete and recreate items to stay under a licence limit. Counters do not go down.
- Record on production or with real customer data.
- Expect dry runs in Report.
- Mix web and mobile screens in one project.
- Put a laptop agent behind a pipeline that runs at night. Use an always-on machine.
- Share the admin account with a colleague or consultant. Create a user.
Didn’t find your answer?Write to support with your project name and what you see on screen.
info@smartestqa.ai