---
title: "Troubleshooting"
section: "Project settings"
description: "Fixes for the SmartestQA Project Panel: access, project name and start page URLs, run settings, AI connection, Selenium and Playwright, mobile and desktop configuration."
url: https://docs.smartestqa.ai/en/project-settings-troubleshooting.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "project panel error problem fix access start page url already registered project name ai test connection api key thread count retry pipeline settings email browserstack aws device farm read apk appium desktop application"
---
# Project settings: Troubleshooting

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

## In short

**On this page you can**

- Look up an exact Project Panel message and see what causes it.
- Fix start page URL, AI connection, mobile and desktop errors.
- Find out why a pipeline still runs with old settings.
- Understand why a value you typed was changed when you saved.

**How to use it**

1. Copy the message you see, or describe the symptom.
2. Find it under its area: access, project, run settings, AI, engines, mobile, desktop.
3. Open the entry and follow Check , then Fix .
4. Still stuck? Write to info@smartestqa.ai with the message and the project name.

## Access

### Problem: Project Panel is greyed out: “Please contact your administrator to access this feature.” _(Access)_

- **Why:** The Project Panel is for Admin and Super Admin. Opening its address with the User role leads to the unauthorized page.
- **Fix:** Ask a company admin to change the setting, or to give you the Admin role in [Company settings › Users](https://docs.smartestqa.ai/en/company-settings-users.html#change-role). Roles: [Who can do what](https://docs.smartestqa.ai/en/company-settings-roles.html).

### Problem: Project Panel is missing from the menu, or “Please select a project” _(Access)_

- **Why:** No project is selected. The panel always edits the selected project.
- **Fix:** Pick a project in the header’s project list, or create one: [Create a project](https://docs.smartestqa.ai/en/quick-start-project.html#create).

### Problem: “Are you sure to exit without saving?” _(Access)_

- **Why:** You are leaving the page, or leaving Mobile Config or Desktop Configuration, with unsaved changes.
- **Fix:** **Save and Exit** saves and continues; if the save fails you stay on the page. **Exit without saving** drops the changes. See [Leaving with unsaved changes](https://docs.smartestqa.ai/en/project-settings.html#unsaved-changes).

## Project and start pages

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

- **Why:** Project names are unique in a company, across all its admins.
- **Fix:** Choose another name, for example with the team or app version. See [Rename the project](https://docs.smartestqa.ai/en/project-settings-project.html#rename).

### Problem: “Project name is required” or “Error updating project name” _(Project)_

- **Why:** The field is empty, or the server did not accept the change (session expired, deleted project).
- **Fix:** Type a name of up to 100 characters and save again. If it keeps failing, reload the page and sign in again.

### Problem: “"*name*" could not be deleted. Please try again or contact support.” _(Project)_

- **Why:** The server refused or did not finish the deletion: the project was already deleted, belongs to another company, or the request was interrupted.
- **Check:** Reload the page. If the project is gone from the header’s list, the deletion went through.
- **Fix:** Try again once. If it fails again, write to [info@smartestqa.ai](mailto:info@smartestqa.ai) with the project name.

### Problem: “Please enter a valid URL (e.g., https://example.com)”, “*field* must start with http:// or https://”, “*field* must not contain spaces.” or “*field* is not a valid URL.” _(Start pages)_

- **Why:** A DEV, TEST or PRP address is not a full web address.
- **Fix:** Paste the address from the browser’s address bar, starting with `https://`, without spaces. See [Add or edit a URL](https://docs.smartestqa.ai/en/project-settings-project.html#url-form).

### Problem: “Name is required.”, “Please enter a name” or “At least one URL (DEV, TEST, or PRP) is required.” _(Start pages)_

- **Fix:** Give the start page a name and at least one address. Save stays greyed out until both are there.

### Problem: “A Start Page with this name already exists…”, “*field* is already registered…”, “A URL is already registered for another Start Page in this project.” or “Duplicate detected for *field*…” _(Start pages)_

- **Why:** In one project, names are unique and each address can be used by only one start page per environment.
- **Check:** Search the list for the name or the address.
- **Fix:** Edit the existing start page instead of adding a second one, or use another name. See [Start page URLs](https://docs.smartestqa.ai/en/project-settings-project.html#start-pages).

### Problem: “Project information is missing. Please refresh and try again.”, “Error saving URL”, “Could not set default URL.” or “"*name*" could not be deleted. Please try again.” _(Start pages)_

- **Why:** The page lost track of the project, or the server did not accept the change.
- **Fix:** Reload the page, check that the right project is selected, and try again.

### Problem: “This URL is being used in other places. Deleting it will remove the URL reference from those items.” _(Start pages)_

- **Why:** Test cases or [pipelines](https://docs.smartestqa.ai/en/schedule-create.html) start on this URL.
- **Fix:** Click the line to see them. Prefer editing the address. If you delete, give those test cases and pipelines another start page. See [Delete a URL](https://docs.smartestqa.ai/en/project-settings-project.html#delete-url).

### Problem: “Export failed” _(Export)_

- **Check:** 1. Your session is still valid: reload the page.
  2. Another export is not still running (the buttons are greyed out while one runs).
  3. Your browser allows downloads from SmartestQA.
- **Fix:** Try again. For a large project, try [**Export as JSON**](https://docs.smartestqa.ai/en/project-settings-project.html#export) first. See [Export the project](https://docs.smartestqa.ai/en/project-settings-project.html#export).

## Run settings

### Problem: A pipeline still runs with the old value after I changed Test Management _(Run settings)_

- **Why:** A [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) copies the project’s settings when it is created and then uses its own copy. [Dry Runs](https://docs.smartestqa.ai/en/automate-dry-run.html) use the project’s current values.
- **Fix:** Open the pipeline in Schedule and change its run settings, or create it again. See [How settings reach a run](https://docs.smartestqa.ai/en/project-settings-test-management.html#how-settings-reach-runs).

### Problem: Thread Count goes back to a lower number when I type or save _(Run settings)_

- **Why:** Thread Count cannot exceed your licence’s Max Thread Count. The field and the server both cap it.
- **Fix:** See your limit in [License Details](https://docs.smartestqa.ai/en/company-settings-billing.html#licence-details). For more threads, an Admin changes the licence in [Billing](https://docs.smartestqa.ai/en/company-settings-billing.html#choose-plan) or contacts SmartestQA. Formula: [Thread Count](https://docs.smartestqa.ai/en/project-settings-test-management.html#thread-math).

### Problem: Thread Count is greyed out _(Run settings)_

- **Fix:** Turn on [**Parallel Execution**](https://docs.smartestqa.ai/en/project-settings-test-management.html#parallel). DESKTOP projects have no parallel block: their test cases run one after another.

### Problem: Retry Count or a timeout changes after I type it _(Run settings)_

- **Why:** Values are kept inside their range: Retry Count 0–5, Wait Timeout and Page Load Timeout 1–120 seconds, Max Tokens 1–8192, Temperature 0–1.
- **Fix:** Enter a value inside the range. See [Retry Count](https://docs.smartestqa.ai/en/project-settings-test-management.html#retry-math).

### Problem: No report email arrives after a pipeline run _(Run settings)_

- **Check:** 1. [**Email Notification**](https://docs.smartestqa.ai/en/project-settings-test-management.html#email) is on in the [pipeline](https://docs.smartestqa.ai/en/schedule-create.html)’s own settings (or, if the pipeline has none, in the project).
  2. [**When to Send**](https://docs.smartestqa.ai/en/project-settings-test-management.html#email) is not **On Failure** for a run where everything passed.
  3. **Email To** is filled; addresses are separated by semicolons.
  4. The spam folder.
- **Fix:** Correct the setting and run the pipeline again. See [Email Notification](https://docs.smartestqa.ai/en/project-settings-test-management.html#email).

### Problem: Passed steps have no screenshot in pipeline reports _(Run settings)_

- **Why:** [**Screenshot On Fail**](https://docs.smartestqa.ai/en/project-settings-test-management.html#test-settings) is on: only failed steps keep a [screenshot](https://docs.smartestqa.ai/en/report-steps.html#screenshots). Or [**Skip Successful Logs**](https://docs.smartestqa.ai/en/project-settings-test-management.html#logging) is on and passed steps have no log at all.
- **Fix:** Turn them off in the [pipeline](https://docs.smartestqa.ai/en/schedule-create.html)’s settings for full evidence. [Dry Runs](https://docs.smartestqa.ai/en/automate-dry-run.html) always take a screenshot per step.

### Problem: The app under test shows English dates or the wrong time _(Run settings)_

- **Why:** The browser runs with [**Browser Locale**](https://docs.smartestqa.ai/en/project-settings-test-management.html#browser) en-US, or (Playwright) with the default timezone Europe/Istanbul.
- **Fix:** Set **Browser Locale** (for example `de-DE`) and, for Playwright, **Timezone**. See [Browser Configuration](https://docs.smartestqa.ai/en/project-settings-test-management.html#browser) and [Playwright Settings](https://docs.smartestqa.ai/en/project-settings-engines.html#playwright).

### Problem: “An error occurred while saving project settings” _(Run settings)_

- **Why:** The server did not accept the save: session expired, network error, or the project belongs to another company.
- **Fix:** Reload the page (your unsaved values are lost), sign in again if asked, and save again.

### Problem: “No changes to save” _(Run settings)_

- **Why:** Every value equals the saved one. Changing a value and changing it back counts as no change.

## AI

### Problem: Test Connection fails (“Connection failed” or one of the messages below) _(AI)_

- **Why:** | Message | Fix |
  | --- | --- |
  | “Enter this provider's API key first.” | Paste the key. |
  | “Enter the Base URL of your local LLM server…” | Fill **Base URL** for OpenAI-compatible / Local. |
  | “The API key was rejected by the provider…” | Paste the whole key; check it belongs to this provider. |
  | “This model is no longer available…” | Use the suggested model, or another one. |
  | “Your account does not have access to this model…” | Pick another model or enable it in the provider console. |
  | “The provider account has no quota or credit left…” | Check billing at the provider. |
  | “Too many requests to the provider.” | Wait the time shown and try again. |
  | “This model does not accept the … setting…” | Change Max Tokens or Temperature, or the model. |
  | “The model returned no answer — the token budget ran out…” | Raise **Max Tokens**. |
  | “The provider's safety filter blocked the response…” | Rephrase the prompt or the test data. |
  | “The provider did not respond in time.” / “The provider could not be reached…” | Check Base URL, network and proxy; a local model must be reachable from the SmartestQA server. |
  | “The AI connection could not be completed…” | Check provider, model and key; open **Technical details**. |
- **More:** Fields: [Use your own account](https://docs.smartestqa.ai/en/project-settings-ai.html#own-account).

### Problem: An AI button is greyed out: “Enable '*…*' in Project Panel → AI Options” _(AI)_

- **Why:** The feature needs [**Enable AI**](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai) and, for some features, one capability switch.
- **Fix:** Turn on the switch the tooltip names and save. Which switch unlocks what: [AI Capabilities](https://docs.smartestqa.ai/en/project-settings-ai.html#what-each-switch-unlocks).

### Problem: The API Key field is empty although a key was saved _(AI)_

- **Why:** The saved key could no longer be read (the server’s encryption key changed). SmartestQA shows it empty rather than pretend it works.
- **Fix:** Paste the key again, click **Test Connection**, then **Save Changes**.

## Selenium and Playwright

### Problem: I don’t see Selenium Settings (or Playwright Settings) _(Engines)_

- **Why:** Only the section of the selected engine is shown, and only in WEB projects.
- **Fix:** Change [Script Language](https://docs.smartestqa.ai/en/project-settings-test-management.html#engine), save, and the other section appears.

### Problem: The proxy is not used _(Engines)_

- **Check:** 1. The value has a port, for example `http://proxy:8080`. Without one the run continues without a proxy and logs “Invalid proxy … running without a proxy”.
  2. Playwright: the run is not [**Run on Server**](https://docs.smartestqa.ai/en/quick-start-connect.html#agent); the Playwright proxy applies on [your agent](https://docs.smartestqa.ai/en/agent-pool-agents.html) only.
  3. The [pipeline](https://docs.smartestqa.ai/en/schedule-create.html)’s own settings contain the proxy (pipelines keep their copy).
- **More:** [How a proxy value is read](https://docs.smartestqa.ai/en/project-settings-engines.html#proxy-rules).

### Problem: The simulated location or a permission has no effect _(Engines)_

- **Fix:** Add `geolocation` to **Permissions**, lowercase, comma-separated. Unknown names are ignored with a warning in the run log. See [Playwright Settings](https://docs.smartestqa.ai/en/project-settings-engines.html#playwright).

### Problem: Runs became very slow _(Engines)_

- **Check:** [**Slow Motion (ms)**](https://docs.smartestqa.ai/en/project-settings-engines.html#playwright) is above 0; [**Wait Timeout (sec)**](https://docs.smartestqa.ai/en/project-settings-test-management.html#timeouts) is high while elements are missing; [**Retry Count**](https://docs.smartestqa.ai/en/project-settings-test-management.html#retry-math) repeats failing cases.
- **Fix:** Set Slow Motion to 0, lower the timeouts, and fix the failing steps.

## Mobile

### Problem: Save Configuration is greyed out: “Select at least 1 test device for AWS Device Farm”, “… for BrowserStack” or “Plan limit exceeded…” _(Mobile)_

- **Why:** The saved mode is AWS Device Farm or BrowserStack and no device is selected, or more BrowserStack devices are selected than your BrowserStack plan’s parallel sessions.
- **Fix:** Open that mode’s card and select devices (or fewer). If you want local runs, click [**Local device**](https://docs.smartestqa.ai/en/project-settings-mobile.html#local) before saving. See [Save Configuration](https://docs.smartestqa.ai/en/project-settings-mobile.html#save).

### Problem: Mobile Config shows Local device although I use AWS or BrowserStack _(Mobile)_

- **Why:** The page opens on the Local device view. The saved mode is still the one you clicked last before saving.
- **Fix:** Click your mode’s card, check its fields and save. See [Execution modes](https://docs.smartestqa.ai/en/project-settings-mobile.html#modes).

### Problem: “Could not load BrowserStack device list (credentials may be wrong or not yet saved)…” _(Mobile)_

- **Fix:** Enter the user name and access key, click **Save Configuration**, then refresh the device list. Only 1 device can be picked until your BrowserStack plan has loaded. See [BrowserStack](https://docs.smartestqa.ai/en/project-settings-mobile.html#browserstack).

### Problem: “Upload failed: *message*” when uploading to AWS Device Farm _(Mobile)_

- **Why:** The server reads the keys and project name from the saved configuration. The message tells which part is missing: configuration not saved yet, AWS credentials missing, AWS project name missing, or an AWS error.
- **Fix:** Fill the AWS fields, save, then upload again. Check the keys are allowed to use [Device Farm](https://docs.smartestqa.ai/en/agent-pool.html) in the chosen region. See [AWS Device Farm](https://docs.smartestqa.ai/en/project-settings-mobile.html#aws).

### Problem: “APK read failed”, “IPA read failed”, or the APK could not be parsed _(Mobile)_

- **Why:** The file is empty, larger than 200 MB, not an `.apk` or `.ipa`, or not a valid app.
- **Fix:** Use the `.apk` or `.ipa` build file itself, not a ZIP of it. If it still fails, type App Package and App Activity, or Bundle ID, by hand. See [Android Configuration](https://docs.smartestqa.ai/en/project-settings-mobile.html#android).

### Problem: “No devices found. Is the agent running on port 8000?…”, or the device picker says the agent was not found _(Mobile)_

- **Why:** SmartestQA asks [your agent](https://docs.smartestqa.ai/en/agent-pool-agents.html) for its connected devices. If the agent does not answer, the picker shows why; in some versions this text appears in Turkish, for example “SmartTest-Desktop bulunamadı…” (agent not found) or “Agent cevap vermedi…” (agent did not respond).
- **Check:** 1. The agent runs on this computer and is green in [Test Agents](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent).
  2. USB devices: USB debugging is on and the “Allow USB debugging” prompt on the phone was accepted.
  3. Simulators are booted.
- **Fix:** Start the agent, connect the device, then click “Refresh device list”.

### Problem: VPN Connectivity Test shows “Connection failed” or “Test could not run” _(Mobile)_

- **Fix:** Read each failed check and its suggestion. BrowserStack Local: the BrowserStackLocal program must run with the same identifier. AWS VPC: VPC ID, at least one subnet and a security group are needed. See [VPN status](https://docs.smartestqa.ai/en/project-settings-mobile.html#vpn).

### Problem: “Failed to save mobile configuration” or “Failed to load mobile configuration” _(Mobile)_

- **Fix:** Reload the page and try again. If it keeps failing, write to [info@smartestqa.ai](mailto:info@smartestqa.ai) with the project name.

## Desktop

### Problem: “Appium Server URL is not valid (e.g. http://localhost:4723)” _(Desktop)_

- **Fix:** Use `http://host:port`, for example `http://localhost:4723`, or leave it empty for the default. See [General Settings](https://docs.smartestqa.ai/en/project-settings-desktop.html#general).

### Problem: “An application with this name already exists”, “Name is required” or “Fill in AUMID / Bundle ID or App Path” _(Desktop)_

- **Fix:** Use a name not yet in the list (case does not matter) and fill the AUMID or bundle ID, or the app path. See [Applications](https://docs.smartestqa.ai/en/project-settings-desktop.html#applications).

### Problem: “No application yet: add one under Applications so tests can open the app” _(Desktop)_

- **Why:** The project has no application in the list. The configuration was still saved.
- **Fix:** Click [**Add application**](https://docs.smartestqa.ai/en/agent-pool-app-library.html#upload), or [**Save current as application**](https://docs.smartestqa.ai/en/project-settings-desktop.html#import-legacy) if it is offered.

### Problem: “Failed to save desktop configuration”, “Application could not be saved”, “Application could not be deleted” or “Applications could not be loaded” _(Desktop)_

- **Fix:** Reload the page and try again. A server reason, if any, is shown after the message.
