User Guide
Comprehensive feature documentation for Testworthy users. This guide covers day-to-day usage, enterprise features, and best practices for getting the most from the platform.
Guide Structure
This user guide is organized by functional area:
- Project Management - Creating, organizing, and managing test projects with AI-powered features
- Test Design & Organization - Creating test cases, hierarchical organization, custom fields, and automation
- Test Execution - Running tests, tracking results, managing defects, and external integrations
- Analytics & Reporting - Dashboards, scheduled reports, usage analytics, and metrics
- Jira Integration - Bidirectional Jira integration setup, configuration, and troubleshooting
- Settings & Administration - Organization management, billing, AI settings, repository integration, and security
- MCP User Guide - Using the Testworthy MCP server with AI assistants in your IDE
Getting Started Checklist
✅ New to Testworthy? Complete the Quick Start Guide first
✅ Ready to dive deeper? Explore the detailed feature guides above
Quick Reference
Common Tasks:
- Create project → Project Management
- Setup billing → Settings & Administration
- Configure Jira → Jira Integration
- Configure AI → Settings & Administration
- Connect repository → Settings & Administration
- Write test cases → Test Design & Organization
- Run tests → Test Execution
- Manage defects → Test Execution
- View reports → Analytics & Reporting
Key Workflows:
- Organization Setup: Settings & Administration → Billing Setup → User Creation → AI Configuration → Jira Integration
- Project Creation: Project Management → Repository Integration → AI-Powered Import → Test Organization
- Test Management: Test Design → Hierarchical Organization → Test Execution → Defect Tracking
- Automation: AI Test Generation → Test Case Healing → Automation Script Export → Repository PR Analysis
- Reporting: Dashboard Analytics → Scheduled Reports → Usage Tracking → Compliance Audit
Platform Navigation
Testworthy's sidebar provides quick access to all major features:
| Sidebar Item | Available To | Description |
|---|---|---|
| Dashboard | All users | Overview statistics, recent projects, and recent test runs |
| Projects | All users | Create, manage, and browse test projects |
| Reports | All users | Generate and view milestone, test plan, and test run reports |
| Jira Integration | All users | Configure and manage bidirectional Jira integration |
| Credits & Billing | All users (label varies by role) | View credit usage, manage subscriptions, and purchase credits |
| Model Pricing | Platform Admin only | Configure AI model pricing and credit charges |
| Organizations | Platform Admin only | Manage organizations and subscription tiers |
| User Management | Platform Admin, Tenant Owner | Create users, assign roles, and allocate credit quotas |
- Create Users: Add new users to the platform and assign roles.
- Edit Users: Update user details, reset passwords, or change roles.
- Delete Users: Remove users who no longer need access.
- Role Management: Assign roles such as Tenant Owner, Org Admin, or QA to control access and permissions.
Integrations
Configure connections to third-party services.
- Available Integrations: Connect to popular third-party tools and services.
- Connect/Disconnect: Easily link or unlink your accounts.
- Configure Settings: Adjust integration-specific settings for your workflow.
- Test Connections: Verify that your integrations are working as expected.
This guide covers all the main features and workflows available in your platform. For more detailed instructions or troubleshooting, refer to the in-app help or contact support.