Platform

Solutions

Resources

Platform

Solutions

Resources

Platform

Solutions

Resources

Blog

How to Write a Usability Testing Script (with Examples and Templates)

Adwitiya Pandey

Published on

eBook CTA Background
RECOMMENDED RESOURCES

The Ultimate Enterprise Guide To Agentic Testing

AI agents can write, fix and triage your tests at scale. See how to use them in QA while keeping people in control of everything that ships.

Get the eBook →

Enterprise guide to agentic testing
eBook CTA Background
RECOMMENDED RESOURCES

The Ultimate Enterprise Guide To Agentic Testing

AI agents can write, fix and triage your tests at scale. See how to use them in QA while keeping people in control of everything that ships.

Get the eBook →

Enterprise guide to agentic testing
eBook CTA Background
RECOMMENDED RESOURCES
Enterprise guide to agentic testing

The Ultimate Enterprise Guide To Agentic Testing

AI agents can write, fix and triage your tests at scale. See how to use them in QA while keeping people in control of everything that ships.

Get the eBook →

eBook CTA Background
RECOMMENDED RESOURCES

The Ultimate Enterprise Guide To Agentic Testing

AI agents can write, fix and triage your tests at scale. See how to use them in QA while keeping people in control of everything that ships.

Get the eBook →

Enterprise guide to agentic testing

Table of contents

Lorem ipsum

Lorem ipsum

Lorem ipsum

Lorem ipsum

Lorem ipsum

You can build the most technically flawless application on the planet and still watch users abandon it in frustration. The gap between what engineers build and what humans actually experience is where usability testing lives. And the quality of your usability test depends almost entirely on one thing: the script.

A usability testing script is the difference between structured insight and expensive guesswork. Done right, it transforms subjective opinions into repeatable, measurable intelligence that drives product decisions. Done wrong, it introduces bias, wastes participant time, and produces data no one can act on.

This guide walks you through exactly how to write a usability testing script that delivers results, with real examples and enterprise templates.



What is a Usability Testing Script?

A usability testing script is a structured document that guides everything a moderator says and does during a usability test session. It covers introductions, background questions, task prompts, follow up probes, and the debrief. Think of it as the operating system for your test session.

The script exists for one purpose: consistency. When you test with five participants or fifty, every single person should receive identical instructions, identical task framing, and identical opportunities to share feedback. Without that consistency, you are not running a test. You are running a series of unrelated conversations.

Usability Testing Script vs. Test Plan


Test Plan

Usability Testing Script

Purpose

Defines why, who and what

Defines how

Contents

Research objectives, participant criteria, metrics, timeline and logistics

The exact words, prompts and sequence the moderator follows

Example

“Evaluate whether new users can complete checkout within three minutes”

“Imagine you’ve found a product you want to buy. Please go ahead and complete the purchase, thinking aloud as you go.”



Moderated vs Unmoderated Usability Testing - Which Script Do You Need?

The format of your test determines the format of your script.


Moderated Testing

Unmoderated Testing

How it works

A moderator guides the participant live, in person or by video call

Participants complete tasks on their own, with no moderator present

Use it when

You need to probe unexpected behaviour, the workflow is complex, or enterprise users have limited time

You need many participants quickly, tasks are self-explanatory, or you want behaviour free from moderator influence

What the script needs

Precise moderator wording, branches for success and struggle, and neutral intervention phrases

Fully self-explanatory task prompts, think-aloud instructions written into each task, and pre-written follow-up questions

Who carries the load

The moderator carries much of it

The script carries all of it

Example: The Same Task, Two Ways

Moderated:
"Imagine your manager has asked for a list of this quarter's open deals.
Show me how you'd find that. Please think aloud as you go."

Unmoderated:
"Your manager has asked for a list of this quarter's open deals.
Find that list in the application. As you work, say out loud what you're
looking for, what you expect to happen and anything that surprises you.
When you've found the list, click 'Done' and answer the questions that follow."
Moderated:
"Imagine your manager has asked for a list of this quarter's open deals.
Show me how you'd find that. Please think aloud as you go."

Unmoderated:
"Your manager has asked for a list of this quarter's open deals.
Find that list in the application. As you work, say out loud what you're
looking for, what you expect to happen and anything that surprises you.
When you've found the list, click 'Done' and answer the questions that follow."
Moderated:
"Imagine your manager has asked for a list of this quarter's open deals.
Show me how you'd find that. Please think aloud as you go."

Unmoderated:
"Your manager has asked for a list of this quarter's open deals.
Find that list in the application. As you work, say out loud what you're
looking for, what you expect to happen and anything that surprises you.
When you've found the list, click 'Done' and answer the questions that follow."
Moderated:
"Imagine your manager has asked for a list of this quarter's open deals.
Show me how you'd find that. Please think aloud as you go."

Unmoderated:
"Your manager has asked for a list of this quarter's open deals.
Find that list in the application. As you work, say out loud what you're
looking for, what you expect to happen and anything that surprises you.
When you've found the list, click 'Done' and answer the questions that follow."



Why Every Usability Test Needs a Script


  1. Eliminates Moderator Bias

Without a script, moderators naturally vary their tone, phrasing, and emphasis across sessions. One participant gets a warm, encouraging prompt. Another gets a terse, clinical one. That variation contaminates your data. A script standardizes delivery so the only variable is the participant's genuine reaction.

  1. Ensures Complete Coverage

During live sessions, it is easy to forget a question or skip a task when the conversation flows in an unexpected direction. The script acts as a checklist. Every objective gets addressed. Every critical question gets asked. Nothing falls through the cracks.

  1. Enables Team Alignment

When multiple researchers, designers, or product managers are involved, the script creates a single source of truth. Everyone agrees on what is being tested and how. This eliminates the post session debates about whether a particular insight is valid because the methodology was inconsistent.

  1. Improves Data Quality

Consistent methodology produces comparable data. When every participant encounters the same tasks in the same sequence with the same framing, you can confidently identify patterns. "Four out of five users struggled with the navigation menu" becomes a defensible finding, not an anecdote.

  1. Respects Participant Time

A well structured script keeps sessions focused and efficient. Participants are giving you their time and attention. A script ensures you make the most of every minute without wandering into tangents that do not serve your research objectives.



How to Write a Usability Testing Script: Step by Step

‍Step 1: Define Your Research Objectives

Before writing any script, decide exactly what you need to learn. Vague objectives such as “get feedback on the app” produce vague results.

A strong objective follows this pattern: “Determine whether [user type] can successfully [complete a specific action] within [a measurable limit] using [product or feature].”

  • Determine whether first-time Salesforce administrators can create a custom report within five minutes without help

  • Evaluate whether insurance claims handlers can find a specific policy in the new policy lookup within three clicks

  • Assess whether retail managers can complete end-of-day reconciliation on the new dashboard without errors

Every part of the script, from tasks to follow-up questions, should trace back to these objectives.

Step 2: Write the Introduction

The introduction makes participants feel safe to behave honestly rather than perform for the moderator. They need to understand what’s happening, why it matters and that they can’t fail.

"Thank you for joining us today. My name is [name] and I'm a [role] at
[company]. We're working on [product or feature], and we want to understand
how people actually use it.

We're testing the product, not you. There are no right or wrong answers.
If something feels confusing or frustrating, that's exactly the feedback
we need.

The session will take about [duration]. I'll ask you to complete a few tasks
and to think aloud as you go, which means saying what you're doing, what you
expect to happen and how you feel about it.

[If recording] With your permission, we'll record this session for internal
research only. You can stop at any time.

Do you have any questions before we start?"
"Thank you for joining us today. My name is [name] and I'm a [role] at
[company]. We're working on [product or feature], and we want to understand
how people actually use it.

We're testing the product, not you. There are no right or wrong answers.
If something feels confusing or frustrating, that's exactly the feedback
we need.

The session will take about [duration]. I'll ask you to complete a few tasks
and to think aloud as you go, which means saying what you're doing, what you
expect to happen and how you feel about it.

[If recording] With your permission, we'll record this session for internal
research only. You can stop at any time.

Do you have any questions before we start?"
"Thank you for joining us today. My name is [name] and I'm a [role] at
[company]. We're working on [product or feature], and we want to understand
how people actually use it.

We're testing the product, not you. There are no right or wrong answers.
If something feels confusing or frustrating, that's exactly the feedback
we need.

The session will take about [duration]. I'll ask you to complete a few tasks
and to think aloud as you go, which means saying what you're doing, what you
expect to happen and how you feel about it.

[If recording] With your permission, we'll record this session for internal
research only. You can stop at any time.

Do you have any questions before we start?"
"Thank you for joining us today. My name is [name] and I'm a [role] at
[company]. We're working on [product or feature], and we want to understand
how people actually use it.

We're testing the product, not you. There are no right or wrong answers.
If something feels confusing or frustrating, that's exactly the feedback
we need.

The session will take about [duration]. I'll ask you to complete a few tasks
and to think aloud as you go, which means saying what you're doing, what you
expect to happen and how you feel about it.

[If recording] With your permission, we'll record this session for internal
research only. You can stop at any time.

Do you have any questions before we start?"

Keep the tone warm but professional, explain the think-aloud method, get consent to record and invite questions.

Step 3: Confirm Confidentiality and Data Consent

Enterprise sessions often involve unreleased features or confidential workflows, so confirm non-disclosure consent before background questions begin.

"Before we start, can I confirm you've received and signed our
non-disclosure agreement? Everything you see today is confidential.
If you have any questions about what you can or can't discuss,
please ask me now

"Before we start, can I confirm you've received and signed our
non-disclosure agreement? Everything you see today is confidential.
If you have any questions about what you can or can't discuss,
please ask me now

"Before we start, can I confirm you've received and signed our
non-disclosure agreement? Everything you see today is confidential.
If you have any questions about what you can or can't discuss,
please ask me now

"Before we start, can I confirm you've received and signed our
non-disclosure agreement? Everything you see today is confidential.
If you have any questions about what you can or can't discuss,
please ask me now

If NDAs were sent in advance, confirm receipt and ask whether the participant has any questions. Don’t assume a signed NDA means the participant has read and understood it.

For participants in the UK and EU, make sure recording consent and data handling meet UK GDPR and GDPR requirements:

"The recording will be stored securely and deleted after [your retention
period]. It won't be shared with third parties. You can withdraw your
consent and ask us to delete it at any time by contacting [contact details]

"The recording will be stored securely and deleted after [your retention
period]. It won't be shared with third parties. You can withdraw your
consent and ask us to delete it at any time by contacting [contact details]

"The recording will be stored securely and deleted after [your retention
period]. It won't be shared with third parties. You can withdraw your
consent and ask us to delete it at any time by contacting [contact details]

"The recording will be stored securely and deleted after [your retention
period]. It won't be shared with third parties. You can withdraw your
consent and ask us to delete it at any time by contacting [contact details]

Set the retention period according to your organisation’s data policy.

Step 4: Ask Background Questions

Background questions help you interpret each participant’s behaviour. A power user struggling with a feature tells you something different from a first-time user struggling with the same feature. Keep this section to around five minutes.

  • “What’s your current role, and how long have you been in it?”

  • “How often do you use [application] in your daily work?”

  • “On a scale of one to ten, how comfortable are you with [relevant technology]?”

  • “Which tools do you currently use for [relevant workflow]?”

  • “Have you used similar products before?”

For a Salesforce study, you might add: “Which Salesforce clouds do you work with regularly?”

Remind participants again that you’re testing the software, not them. This reduces social desirability bias, where people do what they think you want to see rather than what comes naturally.

Step 5: Design Task Scenarios

Task design is where most scripts succeed or fail.

Write Scenarios, Not Instructions

Instead of “Click the Reports tab and create a new report”, write “Your manager has asked for a summary of all open opportunities from last quarter. Please go ahead and pull that together however you normally would.” The first tells participants what to do. The second tests whether they can work it out.

Avoid Interface Wording

If the button says “Generate Report”, don’t use “generate a report” in your task. Use words such as “pull together” or “create”, so participants show real understanding rather than matching words on screen.

Move from Simple to Complex

Start with an easy task to build confidence, then increase difficulty, so early frustration doesn’t affect later tasks.

Limit the Number of Tasks

Five to seven tasks per session is usually enough. More than that leads to fatigue, which affects the quality of your findings.

Include Error Recovery

Add at least one task that involves recovering from a mistake, such as invalid data, a dead end or undoing an action.

Example Tasks: CRM

Level

Task

Simple

“You’ve just received an enquiry from Sarah Chen at Meridian Technologies. Add her to the system with whatever information you think is important.”

Moderate

“Your team meeting starts in ten minutes, and your director wants to know how many deals are expected to close this month. Find that out and tell me what you see.”

Complex

“A customer has called about a problem with their recent order. Find their account, review their order history and log the problem.”

Cross-functional

“Every new lead from the website should receive a welcome email automatically. Walk me through how you’d set that up.”

Example Tasks: Ecommerce

Level

Task

Simple

“You want running shoes in size 10. Find a pair you like and add them to your basket.”

Moderate

“You’ve received a £50 gift card. Apply it to your order and check what you’d still need to pay.”

Complex

“You bought a jacket last week but it doesn’t fit. Start a return and choose an exchange for a different size.”

Example Tasks: ERP

Level

Task

Simple

“Check how much stock you have of product 4421.”

Moderate

“A new supplier has been approved. Add them to the system with 30-day payment terms.”

Complex

“Order 500 units of raw material from your main supplier, apply the agreed discount and send the order for approval.”

Step 6: Prepare Follow-Up Probes

Probes uncover the reasoning behind what you observed, while the experience is still fresh, without suggesting an answer.

Universal probes:

  • “What were you expecting to happen when you clicked that?”

  • “Did anything surprise you about that?”

  • “On a scale of one to five, how easy or difficult was that? What would have made it easier?”

  • “Was there a moment you weren’t sure what to do next?”

Conditional probes:

  • If the participant struggles: “I noticed you paused there. What were you thinking?”

  • If they finish quickly: “That seemed straightforward. What made it easy?”

Avoid leading questions. “Did you find that confusing?” pushes towards an answer, while “How would you describe that experience?” is neutral.

Step 7: Observe Non-Verbal Cues

Participants don’t always say when they’re confused. Their behaviour often tells you first.

Signs of Confusion

Signs of Easy Understanding

Hesitating before clicking

Moving directly through the task

Going back to a previous screen

Commentary that matches what the interface does

Hovering over several options without choosing

Finishing faster than expected

Leaning in or squinting

Relaxed pace and few pauses

Sighing or clicking harder

Confident, specific comments

Log observations alongside your script. “Clicked the wrong button three times before finding Reports” is more useful than “said the navigation was confusing”.

Step 8: Write the Debrief and Close

The debrief often brings out the most honest feedback, because participants are no longer focused on completing tasks.

  • “Now that you’ve used [product], what’s your overall impression?”

  • “What was the most frustrating part, and what was the easiest?”

  • “If you could change one thing, what would it be?”

  • “How does this compare with the tools you use today?”

  • “Is there anything you wanted to say during the tasks but held back?”

Close with thanks and next steps: “Thank you for your time today. Your feedback will directly shape how we improve this product. [Explain incentives and next steps.] If anything else comes to mind, please contact [details].”



Usability Testing Script Template

Session Setup Date: ___Participant ID: ___Moderator: ___Observer(s): ___Product or Feature Being Tested: ___

Introduction (3 minutes)

  • Welcome and introductions

  • Explain the purpose: testing the product, not the person

  • Describe the think-aloud method

  • Confirm recording consent

  • Confirm NDA consent for unreleased features

  • Invite initial questions
    ‍

Background Questions (5 minutes)

  • Role and experience level

  • Familiarity with product category

  • Current tools and workflows

  • Comfort level with technology
    ‍

Task Scenarios (20 to 30 minutes)

Task 1: [Simple warm-up scenario] — Follow-up: [Probing questions]

Task 2: [Moderate complexity scenario] — Follow-up: [Probing questions]

Task 3: [Complex or multi-step scenario] — Follow-up: [Probing questions]

Task 4 (optional): [Edge case or error recovery scenario] — Follow-up: [Probing questions]
‍

Debrief (5 minutes)

  • Overall impression

  • Most and least intuitive elements

  • Comparison to current tools

  • Suggestions for improvement

  • Open floor for additional comments
    ‍

Close (2 minutes)

  • Thank participant

  • Explain next steps and incentives

  • Provide follow-up contact information
    ‍

Total Session Duration: 30 to 45 minutes depending on task complexity

Usability Testing Script Template


Best Practices for Usability Testing Scripts

  1. Keep Sessions Under 30 Minutes

Cognitive fatigue sets in fast. After 30 minutes, participant responses become less reliable. If you need to cover more ground, run multiple focused sessions rather than one marathon.

  1. Pilot Test Your Script

Run through the script with a colleague or internal team member before testing with real participants. You will catch confusing phrasing, unrealistic timing, and tasks that are too easy or too difficult.

  1. Avoid the "Helper" Instinct

When a participant struggles, the natural instinct is to help them. Resist it. Silence is data. Let them work through confusion for a reasonable amount of time before intervening. Script a neutral intervention phrase like "what would you do if I were not here?" to use when necessary.

  1. Use Realistic Data and Environments

Testing with placeholder text like "Lorem Ipsum" or obviously fake data undermines realism. Use representative data that mirrors what users will encounter in production. If you are testing a Salesforce implementation, populate the environment with realistic accounts, contacts, and opportunities.

  1. Separate Usability Testing from Functional Validation

Usability testing answers "can the user figure this out?" Functional testing answers "does the system work correctly?" These are different questions that require different approaches.

Human researchers should focus on the usability dimension: observing confusion, measuring task completion, and capturing qualitative reactions. The functional validation dimension, verifying that buttons work, forms submit correctly, data flows end to end, and the interface renders properly across browsers, should be handled by automation.

This is where AI native test automation fundamentally changes the equation. Platforms built with natural language programming allow teams to write functional tests in plain English, eliminating the need for coded scripts or fragile selectors. Self healing capabilities ensure those automated tests stay reliable even as the application evolves across releases. AI powered root cause analysis pinpoints exactly why a failure occurred.

The result: your QA engineers spend zero time manually clicking through regression scenarios and 100% of their time on high value activities like usability research, exploratory testing, and user experience evaluation. The functional baseline is guaranteed by automation. The human insight comes from usability testing.

  1. Record Everything (With Consent)

Screen recordings, audio, facial expressions, and moderator notes all contribute to a richer analysis. Tools that capture these data streams simultaneously make it easier to correlate what users said with what they actually did.

  1. Test with Five Users, Then Iterate

Research from Nielsen Norman Group consistently shows that five users will uncover approximately 85% of usability issues. Test, analyze, fix, and test again. Iterative usability testing produces better outcomes than a single large study.



Common Usability Testing Script Mistakes to Avoid

1. Leading the Witness

"Do you think this navigation is easy to use?" is a leading question that primes the participant toward a positive response. Rewrite it as: "How would you describe the navigation experience?"

2. Writing Tasks as Instructions

"Click the hamburger menu, then select Settings, then choose Notifications" is a set of instructions, not a test. Rewrite it as: "You are receiving too many email alerts from this application. Find where you would adjust those settings."

3. Testing Too Many Things at Once

Each session should target a focused set of objectives. Trying to evaluate the onboarding flow, the dashboard, the reporting module, and the settings page in a single 30 minute session guarantees shallow insights on everything and deep insight on nothing.

4. Ignoring Edge Cases

Real users do unexpected things. Include at least one task that involves error recovery: what happens when they enter invalid data, navigate to a dead end, or try to undo an action? These moments often reveal the most about the true quality of the user experience.

5. Skipping the Pilot

The first time your script is read aloud should not be during a live session. Every script has phrasing that sounds fine on paper but feels awkward when spoken. Pilot testing catches these issues before they matter.



Usability Testing in Enterprise Environments: Special Considerations

Enterprise applications introduce unique complexity that consumer product testing rarely encounters.

Multi Step Business Processes

Enterprise workflows often span dozens of screens and involve conditional logic. A claims processor in an insurance system might touch five different modules to complete a single task. Your usability script needs to account for this complexity by designing task scenarios that mirror real operational workflows end to end.

Role Based Access and Permissions

Different users see different interfaces based on their permissions. A Salesforce administrator experiences a fundamentally different product than a sales representative. Your script must be tailored to each role, with tasks that reflect what that specific user type actually does.

Integration Touchpoints

Enterprise applications rarely exist in isolation. Data flows between CRM systems, ERP platforms, marketing automation tools, and financial systems. Usability testing should include tasks that cross system boundaries, evaluating whether users can navigate the seams between integrated applications.

Release Cycle Impact

Platforms like Salesforce push three major releases per year, plus monthly updates for features like Agentforce and Data Cloud. Each release can change layouts, introduce new components, and deprecate existing workflows. Usability testing scripts should be version aware, updated to reflect the current state of the platform, and re executed after significant releases.



How AI is Changing Usability Testing

AI isn’t replacing usability testing, but it’s making researchers more effective. AI tools can transcribe sessions, tag moments of hesitation or frustration in recordings and group recurring themes across participants, which cuts the time spent reviewing footage.

AI is also changing the functional testing that sits alongside usability research. When functional tests can be written in plain English, kept current through releases and diagnosed quickly when they fail, teams spend less time clicking through regression and more time on research, exploration and judgement.



Keeping Usability Sessions Focused with Virtuoso QA

Usability sessions go wrong when participants hit bugs instead of design problems. Virtuoso QA keeps the functional baseline in place, so every usability session tests the experience, not whether the build works.

  • Functional journeys are written in plain English, so QA teams and researchers can check the same flows participants will use before each round of sessions

  • Each step runs live as it’s written, and journeys can check the screen, the API and the data behind it

  • When a release changes the interface, Virtuoso QA proposes repairs for a reviewer to accept or reject, so the functional suite stays current between usability rounds

  • Journeys run in parallel across 2,000+ browser and OS combinations, so the build you put in front of participants has already been checked in their browsers

  • When something fails, root cause analysis shows the failed step beside the last passing run, with a likely cause


Frequently Asked Questions

How long should a usability testing script be?

How many tasks should a usability testing script include?

Should I use a moderated or unmoderated usability test?

How do I avoid bias in my usability testing script?

Can AI replace usability testing?

How often should I run usability tests?

Written by

Adwitiya Pandey

Senior Test Evangelist

Adwitiya works directly with QA teams adopting the platform and turns what he sees into practical guides on test design, regression strategy and keeping coverage honest.

See what your next release looks like with Virtuoso

Book a walkthrough on your applications and your workflows. Bring a requirement, a user journey, or a brittle Selenium script, and watch the loop run on something you recognise.

See what your next release looks like with Virtuoso

Book a walkthrough on your applications and your workflows. Bring a requirement, a user journey, or a brittle Selenium script, and watch the loop run on something you recognise.

See what your next release looks like with Virtuoso

Book a walkthrough on your applications and your workflows. Bring a requirement, a user journey, or a brittle Selenium script, and watch the loop run on something you recognise.

Virtuoso QA is establishing the standard of proof for software releases. Its governed QA loop turns business requirements into tests for any browser-based application: AI proposes, a deterministic engine executes, a person approves what matters, and every decision leaves evidence.

Trust Center

AICPA

SOC

WAVE STRONG PERFORMER

@ Copyright 2026 SpotQA, Creators of Virtuoso QA

Virtuoso QA is establishing the standard of proof for software releases. Its governed QA loop turns business requirements into tests for any browser-based application: AI proposes, a deterministic engine executes, a person approves what matters, and every decision leaves evidence.

Trust Center

AICPA

SOC

WAVE STRONG PERFORMER

@ Copyright 2026 SpotQA, Creators of Virtuoso QA

Virtuoso QA is establishing the standard of proof for software releases. Its governed QA loop turns business requirements into tests for any browser-based application: AI proposes, a deterministic engine executes, a person approves what matters, and every decision leaves evidence.

Trust Center

AICPA

SOC

WAVE STRONG PERFORMER

@ Copyright 2026 SpotQA, Creators of Virtuoso QA