Guide

What are acceptance criteria?

Short answer

Acceptance criteria are the specific conditions a single task or user story must meet to be accepted as complete. They describe the expected behaviour from the user's or requester's point of view, are agreed before work starts, and are written so anyone can check them with a clear yes or no. They are usually a short checklist or a set of Given/When/Then scenarios.

Last updated 19 October 2026. Written by the Kaneo team, who also build one of the tools mentioned.

Two common formats

Checklist (rule-oriented)

A list of statements that must all be true. Quick to write and easy to read; suits most tasks.

Given / When / Then (scenario-oriented)

Each criterion is a scenario: given a starting situation, when the user does something, then a specific result happens. Suits behaviour with several paths, and maps directly onto automated tests.

Example: password reset

User story: as a user who forgot my password, I want to reset it by email so that I can get back into my account.

Checklist version: a "Forgot password" link is shown on the sign-in page; entering a registered email sends a reset link within one minute; the link expires after 30 minutes and works only once; entering an unregistered email shows the same confirmation message, so the form does not reveal which emails have accounts; after resetting, the user is signed in and other sessions are signed out.

Given/When/Then version, for one scenario: given a user with a reset link older than 30 minutes, when they open the link, then they see a message that the link has expired and a button to request a new one.

Acceptance criteria vs definition of done

Acceptance criteriaDefinition of done
ScopeOne task or storyEvery task
DescribesWhat this piece of work must doThe quality bar all work must meet
Written byThe requester or product owner, with the teamThe team, once
ExampleThe reset link expires after 30 minutesCode reviewed and tests pass

A template you can copy, and examples for different teams.

How to write good acceptance criteria

Write them before work starts

Criteria written during review describe what was built, not what was needed.

Describe outcomes, not implementation

"The page loads in under two seconds" leaves the team free to choose how. "Add a cache" does not.

Make each one testable

Each criterion should have a clear yes or no answer. "User-friendly" and "fast" are not testable; specific numbers and behaviours are.

Include the unhappy paths

Errors, empty states, and permissions are where most bugs hide and where criteria are most often missing.

Keep the list short

Three to seven criteria is typical. More than that usually means the story should be split.

Acceptance criteria in Kaneo

Write the criteria in the task description as a checkbox list, so they are the first thing the person picking up the task sees and each one can be ticked off during review. For Given/When/Then scenarios, a short list under a heading in the description works well.

During backlog refinement, treat a task without criteria as not ready yet. Moving a task to a Review column before Done gives a clear point where someone other than the author checks each criterion.

Frequently asked

Who writes acceptance criteria?

Usually the product owner or whoever requested the work, refined together with the people doing it. The team's input catches criteria that are ambiguous or unexpectedly expensive.

What is the difference between acceptance criteria and requirements?

Requirements describe what a system or product needs overall. Acceptance criteria are the testable conditions for one specific piece of work, often derived from those requirements.

Do acceptance criteria replace test cases?

No, but they are the starting point. Each criterion usually becomes one or more test cases, and Given/When/Then criteria can often be turned into automated tests directly.

How many acceptance criteria should a user story have?

Typically three to seven. If you need many more, the story is probably too large and should be split.