Skip to main content

​
Overview

Effective test organization makes your test suite easier to navigate, maintain, and scale. Use folders to group related tests, drag-and-drop to rearrange items, and follow naming conventions for clarity.

​
Folder Structure

​
Hierarchy

  • Home (root): Top-level container for all items
  • Folders: Create nested folders to organize by feature, team, or workflow
  • Test cases: Individual automated tests within folders
  • Snippets: Reusable step sequences that can be referenced from any test

​
Creating Folders

  1. Click Create Folder in the Test Explorer header
  2. Enter a descriptive folder name
  3. Select the parent location (Home or existing folder)
  4. Click Create
Alternatively, right-click on any folder and select New Folder to create a subfolder.

​
Folder Naming Conventions

Use clear, consistent names:
PatternExampleUse Case
Feature-basedAuthentication, Checkout, DashboardGroup by product area
Team-basedFrontend, Backend, MobileGroup by team ownership
Flow-basedUser Onboarding, Purchase FlowGroup by user journey
Priority-basedSmoke Tests, Regression, Edge CasesGroup by test priority
Best practices:
  • Keep names concise but descriptive
  • Avoid special characters
  • Use consistent capitalization (Title Case or kebab-case)
  • Limit nesting to 2-3 levels

​
Organizing Tests

​
Drag and Drop

Rearrange tests and folders with drag-and-drop:
  1. Click and hold on a test case or folder
  2. Drag to the target folder
  3. Release to drop
Visual feedback:
  • Target folder highlights when hovering
  • Preview shows item being moved
  • Invalid drop zones are indicated

​
Moving to Home

To move items to the root level:
  1. Drag the item
  2. Drop on the Home area at the top of the explorer
  3. Item moves to root level

​
Bulk Operations

Manage multiple items at once:
  1. Select multiple tests (Shift+click for range, Ctrl/Cmd+click for individual)
  2. Right-click to access bulk actions
  3. Choose Move, Delete, or other actions

​
Test Case Organization

​
Naming Tests

Write descriptive test names that explain what’s being tested: Less clear: 
Test 1
Login test
Cart
More clear: 
User can login with valid credentials
User sees error for invalid password
Guest user can add items to cart

​
Grouping Strategy

Organize tests by: By Feature 
├── Authentication
│   ├── Login with email
│   ├── Login with SSO
│   ├── Password reset
│   └── Logout
├── Shopping Cart
│   ├── Add item to cart
│   ├── Remove item from cart
│   └── Update quantity
By User Journey 
├── Onboarding Flow
│   ├── Sign up
│   ├── Email verification
│   └── Profile setup
├── Purchase Flow
│   ├── Browse products
│   ├── Add to cart
│   ├── Checkout
│   └── Order confirmation
By Priority 
├── Smoke Tests
│   ├── Homepage loads
│   ├── User can login
│   └── Basic checkout
├── Regression
│   └── (detailed tests)
└── Edge Cases
    └── (boundary tests)

​
Snippets Organization

​
Creating Snippets

Snippets are reusable step sequences:
  1. Right-click on a folder
  2. Select New Snippet
  3. Name the snippet descriptively
  4. Add the steps to reuse
Or convert existing test steps:
  1. Open a test case
  2. Select the steps to convert
  3. Right-click and select Save as Snippet

​
Organizing Snippets

Keep snippets organized: 
├── Snippets (folder)
│   ├── Auth
│   │   ├── Login
│   │   └── Logout
│   ├── Navigation
│   │   ├── Go to Dashboard
│   │   └── Go to Settings
│   └── Data Setup
│       ├── Create User
│       └── Create Product

​
Snippet Best Practices

  • Name by action: “Login as Admin”, “Navigate to Checkout”
  • Keep focused: One snippet = one logical action
  • Document parameters: Note required environment variables
  • Version carefully: Changes affect all tests using the snippet

​
Context Menus

​
Folder Actions

Right-click on a folder for:
ActionDescription
New Test CaseCreate test in this folder
New SnippetCreate snippet in this folder
Import Test CaseImport test from file
New FolderCreate subfolder
RenameChange folder name
DeleteRemove folder and contents

​
Test Case Actions

Right-click on a test case for:
ActionDescription
EditOpen test in editor
DuplicateCreate copy in same folder
Save as SnippetConvert to reusable snippet
DeleteRemove test case

​
Best Practices

​
Do

  • Use folders for ownership: Group by team or feature
  • Keep names descriptive: Clear names over abbreviations
  • Limit nesting: 2-3 levels maximum
  • Move over duplicate: Avoid drift from copies
  • Schedule by folder: Plans stay current as tests are added

​
Don’t

  • Don’t over-organize: Don’t create folders for single tests
  • Don’t use deep nesting: Hard to navigate and maintain
  • Don’t duplicate tests: Use snippets for shared steps
  • Don’t use cryptic names: “T1”, “Test_final_v2” are unclear

​
Troubleshooting

​
Cannot Drop Here

  • Ensure you’re dropping onto a folder or Home
  • Check you have permission to modify the target folder
  • Verify the item isn’t being dropped on itself

​
Item Not Moving

  • You may be dropping into the same folder
  • Try a different target location
  • Check for drag-and-drop browser issues

​
Missing Actions

  • Some actions unavailable for system folders (Home)
  • Check permissions for shared workspaces
  • Verify the item type supports the action