← Field Notes

Delivery

The UAT Checklist Nobody Uses

A simple pre-UAT checklist that reduced our client escalations by 60%.3 min read

TL;DR

Most UAT failures aren't code bugs—they're environment issues, missing test data, or unclear acceptance criteria. A 15-minute pre-UAT check catches 80% of the problems that derail testing sessions.

The Pattern We Kept Seeing

UAT session scheduled for 2pm. Client stakeholders clear their calendars. Everyone joins the call. And then:

"The test environment is down."

"I don't have login credentials."

"Where's the test data we discussed?"

"Wait, what exactly are we supposed to be testing?"

Thirty minutes of troubleshooting later, stakeholders are frustrated and the actual testing gets rushed. The next week, we hear about "bugs" that were really just confusion about expected behavior.

We built a simple pre-UAT checklist. Run it the day before testing. It takes 15 minutes and saves hours of wasted stakeholder time.

📋

Pre-UAT Readiness Checklist

Environment (verify 24 hours before)

UAT environment is up and accessible from client network
Latest build deployed — version number matches release notes
All integrations connected — no mocked services unless explicitly agreed
SSL/certificates valid — no browser warnings

Access (verify 24 hours before)

Test accounts created for each UAT participant
Credentials shared via secure channel (not in meeting invite)
Permissions verified — each role can access their required functions
VPN/network access confirmed if testing remotely

Test Data (verify 24 hours before)

Test data loaded — realistic scenarios, not "test123"
Data covers all test cases — edge cases, error conditions included
Data is fresh — reset from previous testing sessions
PII/PHI scrubbed if using production-like data

Documentation (share 48 hours before)

Test scenarios documented — step-by-step with expected results
Acceptance criteria clear — what "pass" looks like for each scenario
Known limitations listed — what's out of scope for this release
Bug reporting process defined — where and how to log issues

The Results

We've used this checklist across 40+ UAT sessions over the past year. The impact:

60%

Fewer escalations

45 min

Avg. time saved per session

90%

Sessions start on time

The biggest win isn't efficiency—it's perception. When UAT sessions run smoothly, clients trust the delivery team. When sessions start with 30 minutes of fumbling, that trust erodes regardless of code quality.

💡

Pro tip: Assign the checklist to someone other than the lead developer. Fresh eyes catch things the team has been staring at for weeks.

Make It Yours

This checklist is a starting point. Add items specific to your technology stack, client requirements, or compliance needs. The key is running it consistently—not the day of testing, but the day before.

Print it. Put it in your project template. Make it a non-negotiable part of your UAT process.

From the field—developed after one too many UAT sessions that started with "Can anyone get into the system?"