TestFinch

Sanity test template

A sanity test template with worked examples: narrow checks of one fix and what sits next to it.

Sanity tests check one change narrowly after a fix or a small release: that the change works and that the things right next to it still do. They are quick and focused, not broad. Examples are for an example online shop; replace them with your own app's.

Download .xlsxDownload .csvDownload .md

5 examples and 15 blank rows, with a How to use tab in the .xlsx

Sanity: 5 worked examples
IDChange checkedCheckStepsExpected resultStatusNotes
SAN-01Fix: discount code ignored at checkoutThe discount applies
  1. Add a product to the cart
  2. Enter the code SAVE10 at checkout
The total drops by 10% and the code shows under the total.Passed
SAN-02Fix: discount code ignored at checkoutAn expired code is refused
  1. Enter an expired code at checkout
A message says the code has expired, and the total is unchanged.Passed
SAN-03Fix: discount code ignored at checkoutRemoving the code restores the total
  1. Apply SAVE10
  2. Select Remove next to the code
The total returns to the full price.Passed
SAN-04New: delivery date on product pagesThe date shows
  1. Open a product that is in stock
An estimated delivery date shows under the price.FailedDate missing on mobile
SAN-05New: delivery date on product pagesOut of stock shows no date
  1. Open a product that is out of stock
No delivery date shows, and the page says when it is back.Passed

FlowQA's agent explores your site and writes cases like this one as tests, keeping each only once it has passed twice and failed on a deliberately broken page. Free to start.

Try FlowQA free

The manual case

SMK-02 A registered user can sign in

  1. Open Sign in
  2. Enter a test account's email and password
  3. Select Sign in

Expected: the account page opens with the user's name.

The FlowQA test

account/sign-in

  1. navigate "/sign-in"
  2. fill "Email" with "mia@acme.example"
  3. fill "Password" with "••••••••"
  4. tap button "Sign in"
  5. assert url matches "/account"
  6. assert text "Mia Chen" is visible

An illustration with sample data.

A sanity test checks one change narrowly: that a fix or a small new feature works, and that the things right next to it still do. A sanity checklist is the short list of those checks, written down so anyone can run them when the build arrives. The table above is a sanity test template with five worked examples for an example online shop, and you can download it as an Excel workbook, a CSV file or Markdown.

How to use it#

  1. Read the examples above. Each row names the change it checks in the Change checked column, so one release can hold several changes.
  2. Select Download .xlsx for a workbook with a How to use tab, the examples and 15 blank rows, or Download .csv to import the rows into another tool.
  3. For each fix or change in a build, add a few rows: the change itself, the case that used to fail, and one or two things beside it.
  4. Run them as soon as the build arrives, and set Status as you go.

What each column means#

Column What goes in it
ID A short, unique reference, so a result or a bug can point at this row.
Change checked The fix or change this row is about, with its ticket or bug reference if you have one.
Check One line saying what is checked about that change.
Steps What to do, one numbered action per line, written so someone new to the app can follow them.
Expected result What should happen if the app works. Write something you can see or check, not 'works correctly'.
Status The result of the last run: Not run, Passed, Failed or Blocked.
Notes Anything that helps the next person: a bug link, test data used, or why a row is blocked.

A sanity checklist for any fix#

Go through these six checks after any fix, and write a row in the template for each one that applies.

  • The case that was reported now gives the expected result.
  • The same steps on the previous build still show the bug, so you know the row can fail.
  • The normal path through the same screen works with ordinary input.
  • One wrong or empty input on that screen is refused with a message.
  • The step right after the fixed one works.
  • The change looks the same at a phone width, if the screen is used on phones.

What the examples show#

The examples cover two changes. For a fixed discount code, they check that the code applies, that an expired code is still refused, and that removing the code restores the total. For a new delivery date on product pages, they check that the date shows, and that an item out of stock shows none. One of those rows failed on mobile, and its note says what was seen.

Sanity testing vs smoke testing#

A smoke test is broad and shallow: a few checks across the whole app that say whether a build is worth testing. A sanity test is narrow and deeper: several checks on the one thing that changed. Some teams use the two names for the same quick check of a build, and the ISTQB glossary, read on 18 November 2026, defines smoke testing and has no entry for sanity testing. Run the smoke test template first, then the sanity rows for each change. If you find yourself checking the whole checkout, the rows belong in the regression test template. Smoke vs sanity vs regression testing follows one release through all three.

Questions#

What is a sanity checklist?#

A short list of checks run after a fix or small change: the change itself, the case that used to fail, and the things beside it. The six checks on this page are one you can reuse.

What goes in a sanity check document?#

The change being checked with its ticket reference, the steps for each check, the expected result, the result of the run and a note for anything that failed. The template's seven columns hold these.

What is the difference between sanity and regression testing?#

Sanity tests check one change quickly. Regression tests re-check features that already worked, across the whole app, so a change does not break them unnoticed.

Should sanity rows be kept after the release?#

Keep the row for a reported bug. Move it into your regression list so the bug cannot come back unnoticed.

Is the template free?#

Yes. Download it without an account and use it in your own plans and tools.