What this module does
A test script is a numbered playbook a human tester (or an automation tool) follows to execute one test case. Each step says:- What to do (“Open the Hire Wizard from the People dropdown”)
- What to enter (“Use the test data shown below”)
- What to verify (“Confirm the wizard advances to Step 2 of 5”)
- The test case’s steps and expected results as the skeleton
- The test case’s test data as concrete values
- Your project’s script templates for consistent tone and format
- Any automation hints (selectors, URLs, API calls) configured for the SF module
Who uses this module
Before you start
You need:- Approved (Active) test cases. See Test Cases.
- (Optional) A script template if your organization uses one. Project Managers can configure templates per SF module. If none is configured, TestFactors uses a sensible default.
Step-by-step: generate a test script
Open the test case

Test case detail with Scripts tab visible (empty on first open).
Click Generate Script
- Template — pick the project’s template or “Default”
- Audience — Manual tester or Automation framework
- Detail level — Concise (~3–5 lines per step) or Verbose (full prose)

Generate Script options panel showing template, audience, and detail level controls.
Generate

Script being generated, streaming new steps in real time.
Review and edit
- Action — what to do (with the right level of detail)
- Data — exact values to enter
- Expected result — what should happen
- Annotation slot — for tester notes during execution

Completed script with 8 steps in Draft state. One step is in inline-edit mode.
Promote to Active

Script header showing Promote button and the version dropdown.
Customizing script templates (Project Managers)
If your team has specific conventions for how scripts should be written (tone, step numbering, screenshot requirements, etc.), set up a template once and every future script follows it.Open project settings
Create or edit a template
- Name — “EC Production Cutover”, “Sandbox Smoke Test”, etc.
- SF Module — scope the template to a specific module, or “All modules”
- Pre-amble — text that appears at the top of every script (e.g. “Run this in the QA sandbox only.”)
- Step format — choose from presets or define your own with placeholders like
{action},{data},{expected} - Post-amble — text at the end (e.g. “Document any defects in Jira project EC-QA.”)
Save and set default

Script template editor with pre-amble, step format, and post-amble fields.
Tips
Generate for one cycle at a time
Pick the right detail level
Regenerate after test case edits
Use one template per SF module
Add screenshots in execution, not generation
Document gotchas in the template, not each script
Script states
Troubleshooting
The script is too verbose / too terse
The script is too verbose / too terse
The test data in the script doesn't match the test case
The test data in the script doesn't match the test case
My team uses a different format for scripts (e.g. ALM, Tricentis)
My team uses a different format for scripts (e.g. ALM, Tricentis)
Generation failed mid-stream
Generation failed mid-stream
- Edit the incomplete steps manually
- Click Resume generation to let the AI finish from where it stopped