Qualflare Documentation

Appearance

Frequently Asked Questions ​

Find quick answers to common questions about Qualflare. Can't find what you're looking for? Check the Troubleshooting guide or browse our detailed documentation.

Getting Started ​

What is Qualflare?

Qualflare is a comprehensive QA test management platform that helps teams organize, execute, and track their software testing efforts. It provides both a web application for manual test management and a CLI tool for integrating automated test results from CI/CD pipelines.

See also: Quick Start Guide, Overview

How does Qualflare work?

Qualflare works by organizing your testing efforts into workspaces (for teams/organizations), projects (for products or applications), and test cases (individual test scenarios). You can group test cases into suites and plans, then execute them as launches. Test results are tracked as case runs, and any issues found are recorded as defects.

See also: Concepts Overview, Organizational Entities

Do I need the CLI tool?

You need the CLI tool if you want to:

  • Integrate automated test results from CI/CD pipelines
  • Upload test results from 20+ frameworks (JUnit, pytest, Jest, Cypress, etc.)
  • Enrich test runs with Git metadata (branch, commit, author)
  • Run tests in automated workflows and report results to Qualflare

If you only do manual testing, the web UI may be sufficient.

See also: CLI Installation, Upload Command

Is there a free trial available?

Yes! Qualflare offers a free tier that includes:

  • Up to 3 users per workspace
  • Unlimited projects
  • Basic test management features
  • Community support

Upgrade to a paid plan for more users, advanced features, and priority support.

See also: Account & Billing

How do I get started?
  1. Sign up for a Qualflare account
  2. Create a workspace for your team or organization
  3. Create a project for your application
  4. Create test cases or import existing tests
  5. Organize tests into suites and plans
  6. Run tests manually or via the CLI tool

See also: Quick Start Guide

Features & Concepts ​

What's the difference between test cases, suites, and plans?
  • Test Case: A single test scenario with steps and expected results
  • Test Suite: A collection of test cases grouped by feature, module, or type
  • Test Plan: A collection of test suites (and individual cases) scheduled for execution together

Think of it like files, folders, and playlists: cases are individual tests, suites organize them, and plans are ready-to-run test playlists.

See also: Test Cases, Test Suites, Test Plans

What are environments?

Environments represent different deployment targets where you run tests (e.g., Development, Staging, Production). Each launch can be associated with an environment, allowing you to track test results across different stages of your deployment pipeline.

See also: Environments, Launches

How do launches work?

A launch is a single execution of a test plan. When you run a test plan, Qualflare creates a launch containing case runs (individual test executions) for each test case in the plan. Launches capture the state of your tests at a point in time, including results, duration, and environment.

See also: Launches, Test Execution Guide

What are shared steps?

Shared steps are reusable test step sequences that can be referenced across multiple test cases. They help you:

  • Avoid duplicating common test procedures
  • Maintain consistency across tests
  • Update steps in one place

For example, a "Login" shared step can be used by any test that requires authentication.

See also: Shared Steps

What are case runs?

A case run is a single execution of a test case within a launch. Each case run has a status (Passed, Failed, Skipped, etc.), duration, and optional notes, screenshots, or defects. Launches contain multiple case runs—one for each test case executed.

See also: Case Runs, Launches

Using the Web UI ​

How do I create a test case?
  1. Navigate to your project
  2. Click Test Cases in the sidebar
  3. Click New Test Case
  4. Enter the test case title, description, and steps
  5. Set priority and automation status
  6. Save the test case

See also: Creating Test Cases, Test Cases Reference

How do I organize tests into suites?
  1. Navigate to Test Suites in your project
  2. Click New Suite
  3. Enter suite name and description
  4. Add test cases to the suite
  5. Save the suite

You can organize suites by feature, module, priority, or any criteria that suits your workflow.

See also: Organizing Tests, Test Suites Reference

How do I run tests?

Manual execution:

  1. Create a test plan with your test suites
  2. Click Run on the test plan
  3. Select the environment
  4. Work through each test case, updating results
  5. Add notes, defects, or attachments as needed

Automated execution:

  • Use the CLI tool to upload results from your CI/CD pipeline
  • Tests run automatically as part of your build process

See also: Executing Tests, Test Reporting

How do I view test results?

Navigate to Launches in your project and click on a launch to see:

  • Overall pass/fail statistics
  • Individual case run results
  • Duration and environment details
  • Associated defects and notes

Use filters to find specific launches by date, environment, or status.

See also: Launches Reference, Analytics

How do I collaborate with my team?

Qualflare supports team collaboration through:

  • Comments: Add comments to test cases, launches, and defects
  • Assignments: Assign defects and tasks to team members
  • Tags: Use tags to categorize and filter items
  • Shared Workspaces: All team members access the same project data
  • Activity Feeds: Track changes and updates across projects

See also: Collaboration Guide

CLI Tool ​

Why should I use the CLI tool?

The CLI tool enables you to:

  • Integrate with CI/CD: Upload test results from automated builds
  • Support 20+ frameworks: JUnit, pytest, Jest, Cypress, Playwright, and more
  • Enrich with Git data: Automatically capture branch, commit, and author information
  • Validate locally: Check test result files before uploading
  • Automate workflows: Incorporate test reporting into your pipeline

See also: CLI Overview, Installation

What frameworks are supported?

The CLI tool supports 20+ testing frameworks, including:

  • Java: JUnit, TestNG
  • Python: pytest, unittest
  • JavaScript: Jest, Mocha, Jasmine, AVA, Tape
  • TypeScript: Jest, Mocha, Jasmine
  • E2E: Playwright, Cypress, Selenium, Puppeteer
  • API: Newman (Postman), REST Assured
  • Performance: k6, Gatling
  • Behavior: Cucumber, SpecFlow
  • Security: OWASP ZAP, Burp Suite

Run qualflare list-formats to see all supported formats.

See also: Upload Command

How do I install the CLI tool?

macOS (Homebrew):

bash
brew install qualflare/tap/qualflare

Linux/macOS (curl):

bash
curl -sSL https://get.qualflare.com/install.sh | sh

Windows (PowerShell):

powershell
irm https://get.qualflare.com/install.ps1 | iex

Docker:

bash
docker pull qualflare/qualflare-cli:latest

See also: Installation Guide

How do I integrate with CI/CD?

Basic integration steps:

  1. Install the CLI in your CI environment
  2. Set environment variables (QUALFLARE_API_KEY, QUALFLARE_PROJECT_ID)
  3. Run your tests
  4. Upload results using qualflare upload

Example (GitHub Actions):

yaml
- name: Run tests
  run: pytest

- name: Upload to Qualflare
  run: qualflare upload test-results/junit.xml
  env:
    QUALFLARE_API_KEY: ${{ secrets.QUALFLARE_API_KEY }}

See also: CI/CD Integration

How does auto-detection work?

The CLI tool automatically detects your test framework based on file patterns:

  • junit.xml, TEST-*.xml → JUnit
  • pytest_results.xml → pytest
  • results.json (Jest format) → Jest
  • cypress/results/*.json → Cypress
  • And 15+ more patterns

If auto-detection fails, specify the format explicitly with --format.

See also: Upload Command

Account & Billing ​

What are the user limits?

User limits depend on your plan:

  • Free: Up to 3 users per workspace
  • Team: Up to 20 users per workspace
  • Enterprise: Unlimited users

Each user gets full access to all features within their assigned workspaces.

See also: Pricing page

What are the workspace limits?
  • Free: 1 workspace
  • Team: Up to 5 workspaces
  • Enterprise: Unlimited workspaces

Each workspace is isolated with its own users, projects, and settings.

See also: Workspaces, Workspace Settings

What pricing tiers are available?
  • Free: $0/month — 3 users, 1 workspace, basic features
  • Team: $XX/month — 20 users, 5 workspaces, advanced features
  • Enterprise: Custom — Unlimited users, SSO, priority support

All plans include access to the CLI tool and core test management features.

See also: Pricing page

How do I upgrade my plan?
  1. Go to Workspace Settings
  2. Click Billing or Subscription
  3. Select your desired plan
  4. Enter payment information
  5. Confirm the upgrade

Changes take effect immediately. Prorated charges apply.

See also: Workspace Settings

How long is test data retained?
  • Free: 90 days
  • Team: 1 year
  • Enterprise: 3+ years (customizable)

Launch history, test results, and attachments are retained according to your plan. Data beyond the retention period may be archived or deleted.

See also: Data export for exporting your data

Technical ​

Is there an API available?

Yes! Qualflare provides a REST API for:

  • Creating and managing test cases
  • Triggering test runs
  • Uploading test results
  • Querying test data
  • Managing workspaces and projects

API documentation is available separately for developers.

See also: API Documentation

Can I export my data?

Yes, you can export:

  • Test cases and suites (CSV, JSON)
  • Test launch results (PDF, CSV)
  • Defect data (CSV)

Use the Export option in the relevant sections or contact support for bulk exports.

See also: Workspace Settings

What integrations are available?

Qualflare integrates with:

  • CI/CD: GitHub Actions, GitLab CI, Jenkins, CircleCI
  • Communication: Slack, Microsoft Teams
  • Issue Tracking: Jira, GitHub Issues, Linear
  • Version Control: GitHub, GitLab, Bitbucket

Configure integrations in Workspace Settings.

See also: CLI Integration

How is my data secured?

Qualflare implements multiple security measures:

  • Encryption: All data encrypted in transit (TLS 1.3) and at rest (AES-256)
  • Authentication: Secure API keys and SSO support
  • Access Control: Role-based permissions per workspace and project
  • Compliance: SOC 2 Type II certified
  • Data Isolation: Each workspace's data is logically separated

See also: Privacy Policy

Can I self-host Qualflare?

Self-hosting is available for Enterprise customers. This includes:

  • Docker containers for easy deployment
  • Kubernetes Helm charts
  • On-premise or private cloud deployment
  • Full control over your data

Contact sales for self-hosting options and licensing.

See also: Enterprise page

What browsers are supported?

Qualflare supports the latest versions of:

  • Google Chrome
  • Mozilla Firefox
  • Apple Safari
  • Microsoft Edge

We recommend using Chrome for the best experience.

Still have questions? Contact our support team or check the Troubleshooting guide.