# Testomat.io Knowledge Base > Answers to common questions about Testomat.io, based on resolved support requests. Every article answers one real support question. Product documentation lives at https://docs.testomat.io. The full text of this knowledge base is available at https://knowledge.testomat.io/llms-full.txt. ## Account & Access - [Can I change the Owner account to a QA role and keep billing access?](https://knowledge.testomat.io/account-access/change-owner-account-to-qa-role-keep-billing-access/): Changing the Owner account to a QA role while keeping billing access on a Read-Only account isn't possible. - [How can I share my test repo with a project leader who is not registered?](https://knowledge.testomat.io/account-access/share-test-repo-with-unregistered-project-leader/): You have two options to share your test repo with a project leader who is not registered: Ongoing access: Invite your project leader by email as a Read-only... - [How do I change a user's role to Manager in a project?](https://knowledge.testomat.io/account-access/change-user-role-to-manager-in-project/): To change a user's role to Manager within a project: Open the project. Go to its members/users section. - [How do I change my profile picture?](https://knowledge.testomat.io/account-access/change-profile-picture/): Access your profile from the account menu in the top-right corner of Testomat.io. - [How do I delete all my account data for GDPR compliance?](https://knowledge.testomat.io/account-access/delete-account-data-gdpr-compliance/): To delete all your account data for GDPR compliance: Contact Support. Send a request to the support team asking to delete all data related to your account. - [How do I transfer projects to another company in testomat.io?](https://knowledge.testomat.io/account-access/how-do-i-transfer-projects-to-another-company-in-testomat-io/): To transfer projects to another company, follow these steps: Ensure you have the necessary permissions to transfer projects. - [Is there a read-only account access in Testomat?](https://knowledge.testomat.io/account-access/read-only-account-access-testomat/): Yes, Testomat.io supports a Read-only role suitable for developers, Product Owners, and other stakeholders. - [What to do if an invite email is not received?](https://knowledge.testomat.io/account-access/invite-email-not-received/): If an invite email is not received, follow these steps: Verify Email Address: Ensure the email address entered for the invite is correct and belongs to the... - [Why can't I join a company project on Testomat?](https://knowledge.testomat.io/account-access/join-company-project-testomat/): Having the same email domain as your company does not automatically connect you to the company on Testomat. - [Why does SSO login fail with an email claim error?](https://knowledge.testomat.io/account-access/sso-lockout-email-claim-mismatch/): This usually means Azure isn't sending the email claim in the exact form Testomat.io expects. Work through these four checks. ## AI Features - [Can AI assistants connect to Testomat.io?](https://knowledge.testomat.io/ai/testomat-io-mcp-connectivity-claude-code/): Yes. Testomat.io provides an MCP Server that lets MCP-compatible AI assistants connect to the Testomat.io Public API v2. - [How do I fix the AI provider request failed error when using the AI agent for test suite description?](https://knowledge.testomat.io/ai/fix-ai-provider-request-failed-error/): Enable Automatic AI Request Retry via OpenRouter to keep AI features working smoothly even when your primary provider has an outage. - [Is MCP available in Testomat?](https://knowledge.testomat.io/ai/mcp-availability-in-testomat/): Yes, Testomat supports MCP. You can find the MCP tools and more information on GitHub: https://github.com/testomatio/mcp MCP on GitHub Full list of available... - [What AI Agents functionality is included in the Professional plan?](https://knowledge.testomat.io/ai/ai-agents-functionality-professional-plan/): No, AI Agents functionality is not included in the Professional plan. AI Agents, including features like Deep Analyze and Mark Flaky Tests, is an advanced... - [Where can I find the Testomat MCP for Claude?](https://knowledge.testomat.io/ai/locate-testomat-mcp-for-claude/): Testomat.io has an MCP Server that connects Claude Desktop to your project, so your assistant can read, search, and manage tests, suites, and runs. - [Why are custom labels missing in MCP tool calls?](https://knowledge.testomat.io/ai/custom-labels-missing-mcp-tool-calls/): Ensure you are on the latest release version and not using a beta version. Follow these steps to work with custom labels: Call labels_list or project_info to... - [Why can't I connect to the Testomat.io MCP Server?](https://knowledge.testomat.io/ai/cannot-connect-testomat-mcp/): The connection issue is likely related to API access rather than the MCP client itself. ## API - [Can I create a Testomat branch programmatically via API?](https://knowledge.testomat.io/api/create-testomat-branch-programmatically-api/): You can create a new branch in Testomat programmatically using APIv2. The POST /api/v2/{project_id}/branches endpoint allows branch creation. - [How do I fix the 'no implicit conversion of nil into String' error when creating a plan via API?](https://knowledge.testomat.io/api/fix-no-implicit-conversion-error-creating-plan-api/): These errors are due to an invalid request structure. The request body format is invalid. - [How do I get the project ID and API token?](https://knowledge.testomat.io/api/get-project-id-api-token/): To get the project ID and API token: Open Account Settings. Go to Access-Tokens. - [How do I push test cases to a folder via API?](https://knowledge.testomat.io/api/push-test-cases-to-folder-via-api/): To push test cases to a specific folder via API, follow these methods depending on your situation: For existing tests: It is not possible to move individual... - [How do I send a public report link to Slack after each CI run?](https://knowledge.testomat.io/api/automate-public-report-generation-ci/): Enable Public Report Sharing: Go to Company Settings, then Sharing, and Enable Public Report. ## Automation - [Can I get a demo on how automated tests work in Testomat.io?](https://knowledge.testomat.io/automation/demo-automated-tests-testomat-io/): Yes, you can request a demo to understand how automated tests work in Testomat.io. - [Can I import custom metadata (like descriptions) for automated tests?](https://knowledge.testomat.io/automation/import-custom-metadata-playwright-tests/): No, Testomat.io doesn't import custom metadata fields for automated tests. Fields like description, examples (expected values), and steps exist for manual... - [Can I import parametrized CodeceptJS tests?](https://knowledge.testomat.io/automation/import-codeceptjs-dynamic-scenario-names/): Yes, you can import parametrized CodeceptJS tests, but the scenario name must be readable as plain text for the importer to recognize it. - [Can I upload Playwright results to Testomat.io without configuring an external S3 bucket?](https://knowledge.testomat.io/automation/upload-playwright-results-without-s3/): Yes for results, no for artifacts. Your test results, the tests, their statuses, and their steps, always sync to Testomat.io with no S3 needed. - [Can we use Playwright in SAP BAS?](https://knowledge.testomat.io/automation/use-playwright-in-sap-bas/): Yes, you can use Playwright in SAP Business Application Studio (BAS) with Testomat.io. - [Does Testomat support custom @step decorators in Playwright?](https://knowledge.testomat.io/automation/testomat-support-custom-step-decorators-playwright/): No, Testomat does not fully support importing steps created via custom @step decorators in Playwright projects. - [How can I set predefined examples for API test cases via the API?](https://knowledge.testomat.io/automation/set-predefined-examples-api-test-cases/): To create test cases with example data already filled in using the API, first create the test with its column names, then add the data rows one by one. - [How do I import Playwright tests from a specific folder?](https://knowledge.testomat.io/automation/export-tests-specified-folder-playwright/): To import Playwright tests from a specific folder, use file patterns and environment variables to scope the import. - [How do I resolve duplicate Test IDs when using Mocha?](https://knowledge.testomat.io/automation/resolve-duplicate-test-ids-mocha/): Duplicate Test IDs can occur when running the check-tests script with Mocha, especially if multiple tests in a file lack existing Testomatio IDs. - [How do I set up GitHub Actions workflows for Playwright?](https://knowledge.testomat.io/automation/setup-github-actions-workflows-playwright/): You can configure GitHub Actions to run Playwright tests and report results to Testomat.io. - [Is the Vitest adapter compatible with Vitest 4.x?](https://knowledge.testomat.io/automation/vitest-adapter-compatible-with-vitest-4/): Yes. Use the latest version of the Testomat.io Reporter — it is compatible with Vitest 4.x. - [Why does my CI job hang on the Testomatio reporter finish step?](https://knowledge.testomat.io/automation/ci-job-hangs-testomatio-reporter-finish/): The CI job hangs due to a coding error in your test process, specifically using 'catch' instead of 'finally', which prevents termination. - [Why don't I see attachments in the run report?](https://knowledge.testomat.io/automation/no-attachments-in-run-report/): Ensure that the add_artifacts method is called with a flat list of artifact URLs. - [Why is a failed test marked as successful with 'retry successful' notice in PHPUnit?](https://knowledge.testomat.io/automation/failed-test-marked-successful-phpunit/): A failed test in PHPUnit may be marked as successful with a 'retry successful' notice if test IDs are reused due to @group annotations in your test code. - [Why is there a test count mismatch between Playwright and Testomat?](https://knowledge.testomat.io/automation/test-count-mismatch-playwright-testomat/): The mismatch in test counts between Playwright and Testomat is due to the way parameterized tests are handled. ## Billing & Legal - [Can I use the free license for two testers without violating the Terms of Service?](https://knowledge.testomat.io/billing/free-license-two-testers-terms-of-service/): Yes, you can use the free license for up to two testers without violating the Terms of Service. - [Does using AI features increase my monthly bill?](https://knowledge.testomat.io/billing/ai-features-impact-monthly-bill/): Using AI features with Testomat.io's built-in AI provider does not increase your monthly bill. - [How can I extend my Testomat.io trial period?](https://knowledge.testomat.io/billing/extend-testomat-trial-period/): To extend your Testomat.io trial period, you can request an extension for an additional 14 days. - [How can I request an invoice for additional licenses?](https://knowledge.testomat.io/billing/request-invoice-additional-licenses/): Contact the support team to request an invoice for additional licenses. They will provide the necessary details and send the invoice to your email. - [Is Testomat.io HIPAA compliant and can a BAA be signed?](https://knowledge.testomat.io/billing/hipaa-compliance-baa-signing/): No, Testomat.io is not currently HIPAA compliant and cannot sign a BAA. Testomat.io does not have a HIPAA certificate at this time. - [Is the Accountant role user free?](https://knowledge.testomat.io/billing/accountant-role-user-free/): Yes, the Accountant role is considered a free user. Adding Accountant users does not increase your paid seat count, and you can add multiple accountants at no... - [What are the attachment size limits on the Professional tier?](https://knowledge.testomat.io/billing/attachment-size-limits-professional-tier/): The attachment size limit for the Professional plan is 50 MB per attachment. The limit applies to files attached to test cases, such as PDF documents or... - [Why is my project locked?](https://knowledge.testomat.io/billing/why-is-my-project-locked/): A project can be locked when your subscription ends, is canceled, or falls back to the Free plan. ## Getting Started - [How can I create a new project in Testomat.io?](https://knowledge.testomat.io/getting-started/create-new-project-in-testomat-io/): Register at app.testomat.io and activate your account. Open the Dashboard. Click New Project. - [How do I start a free trial of Testomat.io?](https://knowledge.testomat.io/getting-started/start-free-trial-testomat-io/): You can start a free trial of Testomat.io anytime by signing up on the website. Use this link to get started: https://testomat.io/. ## Integrations - [Can I run specific tests with Testomat.io GitHub integration for Python/pytest?](https://knowledge.testomat.io/integrations/run-specific-tests-testomat-github-python-pytest/): You can run specific tests with Testomat.io GitHub integration for Python/pytest. - [Can I select which API user links a Linear ticket in Testomat.io?](https://knowledge.testomat.io/integrations/select-api-user-link-linear-ticket/): No, you cannot select a specific API user when linking an existing Linear ticket in Testomat.io. - [Do Slack notifications reflect the project timezone setting?](https://knowledge.testomat.io/integrations/slack-notifications-project-timezone/): Yes, Slack notifications now reflect the project timezone setting after a recent update. - [How can I test my application in Jira using Testomat.io?](https://knowledge.testomat.io/integrations/test-application-in-jira-using-testomat-io/): Yes, you can test your application in Jira using the Testomat.io plugin. Install the Testomat.io plugin in your Jira instance. - [How do I activate the Linear integration?](https://knowledge.testomat.io/integrations/activate-linear-integration/): To activate the Linear integration in Testomat.io: Open your project’s Integrations or Issues Management Systems settings. - [How do I link a test run to a Jira issue?](https://knowledge.testomat.io/integrations/link-test-run-to-jira-issue/): You can link a test run to a Jira issue from the run itself: Open the failed manual or automated run. - [How do I migrate test cases from Xray to Testomat?](https://knowledge.testomat.io/integrations/migrate-test-cases-from-xray-to-testomat/): Migrating from Xray is a two-stage process, and the test IDs are what keep your CI results from duplicating. - [How do I resolve the 'Header row not found' error when importing from Zephyr?](https://knowledge.testomat.io/integrations/resolve-header-row-not-found-error-zephyr-import/): To resolve the 'Header row not found' error when importing test cases from a Zephyr CSV file into Testomat.io, adjust your CSV file to match the format... - [How do I update the Jira subdomain in Testomat.io integration?](https://knowledge.testomat.io/integrations/update-jira-subdomain-integration/): Update the Jira subdomain in your Testomat.io integration by following these steps: Change the Jira URL in the integration settings to the new subdomain. - [How to import the 'ID' field from TestRail?](https://knowledge.testomat.io/integrations/import-id-field-from-testrail/): To import the 'ID' field from TestRail, consider the following workarounds: Use an API Migration Script This method transfers all standard and custom fields. - [What Bitbucket token type and scopes are needed for Testomat to post PR comments?](https://knowledge.testomat.io/integrations/bitbucket-token-type-scopes-pr-comments/): To post PR comments in Bitbucket using Testomat, use a Repository Access Token. Verify PR Context: Ensure the pipeline job is triggered from a pull-requests... - [Why am I not receiving Slack notifications despite a valid webhook and rules?](https://knowledge.testomat.io/integrations/slack-notifications-not-received-valid-webhook-rules/): A valid webhook and a saved rule aren't enough — the run must also match the rule. - [Why are some columns ignored and not imported from Zephyr (.xlsx)?](https://knowledge.testomat.io/integrations/columns-ignored-not-imported-zephyr-xlsx/): Some columns like Key, custom fields, and Status may be ignored during the import process from a Zephyr .xlsx file. - [Why does Linear integration say 'team not found'?](https://knowledge.testomat.io/integrations/linear-integration-team-not-found/): Ensure you are using the correct Linear team name, not the workspace name, during the integration setup. - [Why does my workflow always run on `main` even though I set `ref`?](https://knowledge.testomat.io/integrations/ref-variable-not-working-testomat-ci-integration/): No, nothing is wrong on the Testomat.io side. This is how the GitHub Actions API works. - [Why is my Jira integration not working and showing linking errors?](https://knowledge.testomat.io/integrations/jira-integration-linking-errors/): To resolve Jira integration and linking errors, follow these steps: Clear your browser cache and retry the integration process. ## Reporting & Analytics - [Does Testomat.io provide a model usage tracking report?](https://knowledge.testomat.io/reporting-analytics/model-usage-tracking-report/): Yes, Testomat.io provides a Usage Statistics report that includes AI usage. You can filter this report by date range, project, or user. - [How do I access the Usage Statistics feature in Testomat.io?](https://knowledge.testomat.io/reporting-analytics/access-usage-statistics-feature/): Usage Statistics is one of the Company Statistics widgets, alongside Data Statistics, User Activity, and AI Usage. - [What does TESTOMATIO_SHARED_RUN_TIMEOUT do?](https://knowledge.testomat.io/reporting-analytics/testomatio-shared-run-timeout-configure/): It's used when you run tests in parallel and want all those parallel jobs to report into a single run in Testomat.io, instead of creating a separate run each. - [Why do I get an 'Access Denied' error when accessing S3 files in Testomat Reporting UI?](https://knowledge.testomat.io/reporting-analytics/access-denied-error-s3-testomat-reporting-ui/): To fix the 'Access Denied' error when accessing S3 files in the Testomat Reporting UI, enable the 'private artifacts' toggle. - [Why does my dashboard query throw an error?](https://knowledge.testomat.io/reporting-analytics/custom-dashboard-creation-error-query/): Tests and Runs use different TQL variables. A query written for tests won't work on runs. Check which one your widget uses, then use that entity's variables. ## Test Management - [Can I add parameterised variables in a test?](https://knowledge.testomat.io/test-management/add-parameterised-variables-in-test/): Yes, you can add parameterized variables in Testomat.io for automated tests, manual tests, and BDD Scenario Outlines. - [Can I automate the addition of new tests to a test plan?](https://knowledge.testomat.io/test-management/automate-test-addition-to-test-plan/): Yes, you can automate the addition of new tests to a test plan using tags/labels and suites in Testomat.io: Base the test plan on tags/labels Create a test... - [Can I customize the result fields for each test case?](https://knowledge.testomat.io/test-management/customize-test-result-fields/): No, you cannot directly customize the built-in result fields for each test case. However, you can use custom statuses to add additional context. - [Can I export test cases for a specific period in Testomat.io?](https://knowledge.testomat.io/test-management/export-test-cases-specific-period/): No, Testomat.io does not support direct export for a specific period. However, you can filter the data using the Test Query Editor and then export the results. - [Can I remove the 'Shared' icon from copied test cases?](https://knowledge.testomat.io/test-management/remove-shared-icon-copied-test-cases/): To remove the 'Shared' icon from copied test cases, use the Unlink Share feature. - [Can I see the history of changes to my test plans and runs?](https://knowledge.testomat.io/test-management/view-history-of-changes-test-plans-runs/): Yes. Changes to your test plans and runs are tracked in Pulse, your project's activity log and version history. - [Can you parse pytest marks as tags in Testomat.io?](https://knowledge.testomat.io/test-management/parse-pytest-marks-as-tags/): Yes — starting with pytestomatio 2.13.0b0 (beta), pytest markers can be synced to Testomat.io as tags. - [How can I add tests to a test run during editing?](https://knowledge.testomat.io/test-management/add-tests-to-test-run-during-editing/): You can add tests to a run that's already started, without stopping your testing. Open the run in edit mode and pick the tests you want. - [How can I undo imported test cases in Testomat?](https://knowledge.testomat.io/test-management/undo-imported-test-cases-testomat/): You can undo imported test cases by bulk deleting them through the Testomat UI. Bulk-select the imported test cases you want to remove. - [How do I create a test plan?](https://knowledge.testomat.io/test-management/set-up-test-plan-testomat-io/): You create a plan from the Plans page. Go to the Plans page. Click the + New plan dropdown. - [How do I fix unwanted labels/tags and missing test types after a Zephyr import?](https://knowledge.testomat.io/test-management/fix-unwanted-labels-tags-missing-test-types-import/): These issues were fixed in a Testomat.io release. Here's how to tidy up an import you've already done. - [How do I restore archived or purged test runs?](https://knowledge.testomat.io/test-management/test-cases-skipped-jira-links-missing/): Yes. Purged and archived runs aren't deleted, they're moved to the Archive, so you can restore them at any time. - [How should I organize automated and manual tests in Testomat?](https://knowledge.testomat.io/test-management/organize-automated-manual-tests-testomat/): For organizing automated and manual tests in Testomat, keep them in the same suite for convenience. - [My test selection is too big for one plan. Can I still run it all at once?](https://knowledge.testomat.io/test-management/resolve-query-sorting-issues-test-plans/): No, but you can split the selection across several test plans and combine those plans into a single run. - [Why am I getting a runtime error when importing a CSV into Testomat?](https://knowledge.testomat.io/test-management/runtime-error-importing-csv-testomat/): Check CSV Columns — Open your CSV file and verify that it includes the columns ID, Title, and Folder. These columns are mandatory for the import process. - [Why are my bulk inserted tests not appearing and showing duplicate errors?](https://knowledge.testomat.io/test-management/bulk-inserted-tests-not-appearing-duplicate-errors/): The issue is due to duplicates in the tests you are inserting in the bulk test create area. - [Why do bulk-edit options differ between test cases?](https://knowledge.testomat.io/test-management/bulk-editing-options-automated-test-suites/): This is expected behavior, not a bug. Bulk Edit only shows content that's stored in Testomat.io. ## Test Runs - [Can an environment name include a period?](https://knowledge.testomat.io/test-runs/environment-name-period-new-run/): Yes, environment names can include periods, so Creo10.0 works normally. Go to Settings in the sidebar. - [Can I create a manual run without a test plan?](https://knowledge.testomat.io/test-runs/create-manual-run-without-test-plan/): Yes. A test plan is only one of four ways to fill a run - you can start a run with no tests at all and add them later. - [Can I pass specific test suites to a run in CI?](https://knowledge.testomat.io/test-runs/pass-custom-test-suites-to-mixed-run-ci/): Yes. You can choose specific test suites to run in CI by selecting them in a multi-select dropdown when creating an automated or mixed run in Testomat.io. - [Can I reduce the shared run timeout duration?](https://knowledge.testomat.io/test-runs/reduce-shared-run-timeout-duration/): The default timeout for shared runs is 30 minutes after the last shard finishes. To reduce this duration, an environment variable has been introduced that... - [Does a retry make a test flaky?](https://knowledge.testomat.io/test-runs/flaky-test-detection-retries/): No. A retry inside a single run doesn't mark a test as flaky. Flakiness is worked out statistically across runs, not from retries. - [How can I prevent attachments from getting lost during long test runs?](https://knowledge.testomat.io/test-runs/prevent-attachments-lost-long-runs/): Increase the S3 session token duration to ensure it does not expire before the test run completes. - [How do I assign users to a run as teams?](https://knowledge.testomat.io/test-runs/assign-users-to-run-as-teams/): You can't assign a Team to a run directly. Teams control which projects a group of users can access — run assignment always happens per user. - [Why are selected tests not resetting to Pending in Advanced Relaunch?](https://knowledge.testomat.io/test-runs/selected-tests-not-resetting-pending-advanced-relaunch/): No, selected tests may not reset to Pending status during an Advanced Relaunch when 'Create new run' is set to OFF. - [Why can't I re-add a deleted test case to a test run?](https://knowledge.testomat.io/test-runs/re-add-deleted-test-case-test-run/): To restore a deleted test case to a test run: Go to "Edit Manual Run". Click the "Details" link. - [Why is the Test Runs Graph not displaying?](https://knowledge.testomat.io/test-runs/test-runs-graph-not-displaying/): The Test Runs Graph requires a minimum of 3 RunGroups to be displayed. Each RunGroup is treated as one unit for the chart. ## Troubleshooting - [Does Testomat.io initiate any outbound connections by default in on-premise deployment?](https://knowledge.testomat.io/troubleshooting/outbound-connections-on-premise-deployment/): No, Testomat.io does not initiate any outbound connections by default in an on-premise deployment. - [How can I view the full error message when troubleshooting?](https://knowledge.testomat.io/troubleshooting/view-full-error-message-troubleshooting/): Use browser DevTools to view the full error message. Open DevTools: Right-click on the page and select 'Inspect' or press F12 to open the browser's Developer... - [How do I resolve errors when setting up an S3 bucket for Testomat.io?](https://knowledge.testomat.io/troubleshooting/resolve-s3-bucket-setup-errors-testomat/): To resolve errors when setting up an S3 bucket for Testomat.io, update IAM permissions, whitelist Testomat.io IPs, and verify bucket access policies: Update... - [Why am I getting an error when linking a task to a test case?](https://knowledge.testomat.io/troubleshooting/linking-task-to-test-case-error/): The error is caused by an expired key. Update the expired key. Once the key is updated, linking tasks to test cases works again. - [Why do `---` dividers cause odd formatting in test cases?](https://knowledge.testomat.io/troubleshooting/dividers-cause-odd-formatting/): The Classical editor uses Markdown, where --- has two different meanings depending on what comes before it.