Creating & Editing Requirements - Step Guide
Creating Requirements
To create a new requirement:
- Click the Create Requirement button in the header (or press
Ctrl+N) - Fill in the requirement details:
Title: A concise name for the requirement (required)
Description: A brief summary of what the requirement entails
Details: Rich text editor for detailed requirement specifications. You can:
- Format text (bold, italic, headings, lists)
- Add links
- Insert code blocks
- Upload images and files
- Use parameters (e.g.,
{{BASE_URL}})
Type: Select the requirement type from the dropdown:
- Feature
- Bug Fix
- Performance
- Enhancement
Status: Select the initial status:
- Draft
- In Progress
- In Review
- Approved
- Rejected
Custom Fields: If your project has custom fields configured for requirements, they will appear here. Fill them in as needed.
Test Cases: Link existing test cases to this requirement:
- Click Add Test Cases
- Select test cases from the test case selector
- Click Add to link them
Attachments: Upload files related to the requirement:
-
Click the attachment area or drag and drop files
-
Files are uploaded automatically
-
Add captions to images for better context
-
Click Save to create the requirement
Keyboard Shortcuts
Ctrl+N: Create a new requirementCtrl+F: Toggle advanced filtersCtrl+A: Select all requirementsCtrl+Shift+C: Toggle column managerCtrl+Shift+A: Toggle analytics panelEscape: Clear selection, close panels
Editing Requirements
To edit a requirement:
- Open the requirement details (click on the requirement row)
- Click the Edit button
- Modify the fields as needed:
- Title
- Description
- Details (rich text editor)
- Type
- Status
- Custom fields
- Linked test cases
- Click Save to update the requirement
Quick Edit
You can quickly edit the type or status directly from the table:
- Click on the type or status badge in the table
- Select a new value from the dropdown
- The change is saved automatically
Deleting Requirements
To delete a requirement:
- Open the requirement details
- Click the Delete button
- Confirm the deletion in the confirmation modal
Note: Deleting a requirement removes:
- The requirement details
- Attachments
- Links to test cases
Note: Existing releases and past test executions are not affected.
Permissions
Requirements are subject to project-level permissions:
- View Requirements: View requirements list and details
- Create Requirements: Create new requirements
- Edit Requirements: Modify existing requirements
- Delete Requirements: Remove requirements
Permissions are managed at the project level through roles. Contact your project administrator if you need additional permissions.
Was this page helpful?