Overview
TestLodge is a test case management tool that helps QA teams organize and execute tests. The Shortcut integration links test cases to Stories and automatically creates bug Stories when tests fail.
Key Features
- Test Case Linking: Connect test cases to Shortcut Stories
- Bug Creation: Failed tests create bug Stories automatically
- Coverage Visibility: See test coverage for Stories and Epics
- Results Tracking: Test results visible in Story context
Setting Up the Integration
- In TestLodge, go to Project Settings > Integrations
- Select Shortcut from the list
- Enter your Shortcut API token
- Configure default settings:
- Target Team
- Bug Workflow state
- Default labels
Project admin access in TestLodge is required to configure integrations.
Using the Integration
Linking Test Cases to Stories
When creating or editing test cases:
- Add the Shortcut Story ID in the reference field
- Test cases appear linked to the Story
- View all related tests from within Shortcut
Creating Bugs from Failed Tests
When a test fails:
- Click Create Bug in Shortcut
- Test details are pre-populated:
- Test case name and steps
- Expected vs. actual results
- Environment information
- Review and submit the bug Story
Viewing Test Coverage
In Shortcut, Stories show:
- Number of linked test cases
- Pass/fail status summary
- Link to full test details
Best Practices
- Link acceptance criteria tests to Stories
- Create bugs immediately when tests fail
- Use consistent naming for traceability
- Include environment details in bug Stories