Agile Glossary

User Story Template

What is User Story Template?

A user story template is a common format used to write user stories that help you include key pieces of information about that user story.

One particular template, often referred to as “As a… I want to… So That…” is the most commonly recommended aid (often outgrown once past the novice stage) for teams and product owners starting to work with user stories and product backlog items in general:

  • As a (who wants to accomplish something)
  • I want to (what they want to accomplish)
  • So that (why they want to accomplish that thing)

An example:

  • As a bank customer
  • I want to withdraw money from an ATM
  • So that I’m not constrained by opening hours or lines at the teller’s

Also Known As

Another name is the “Connextra format”, in recognition of its origins (see below).

Expected Benefits

This template serves as “training wheels”, reminding people in conversation about user stories to pay attention not just to “what” the desired software product is to do, but also “for whom” it does it and in pursuit of “what objectives”.

Common Pitfalls

Many novice teams fall into rote application of this or some other user story format. In fact, such formats are intended more as checklists. A more relaxed phrasing is often just as effective at communicating the overall intent of a user story. Since the greatest amount of detail about a user story will in any case arise in conversation between members of the team, often quite sometime after initially writing a story card, spending much effort and time on complying with user story templates is without much point.

Origins

  • 2001: the “role-feature-reason” format for expressing user stories is invented at Connextra in the UK

Join us today!

Agile Alliance offers many online and in-person events and workshops for our members. If you’re not currently a member, you can join now to take advantage of our many members-only resources and programs. LEARN MORE >

Get the latest Agile news!

  • This field is for validation purposes and should be left unchanged.

By subscribing, you acknowledge the Agile Alliance Privacy Policy, and agree to receive our emails.

Additional Agile Glossary Terms

The daily meeting is one of the most commonly practiced Agile techniques and presents opportunity for a team to get together on a regular basis to coordinate their activities.
Usability testing is an empirical, exploratory technique to answer questions such as "how would an end user respond to our software under realistic conditions?"
The team meets regularly to reflect on the most significant events that occurred since the previous such meeting, and identify opportunities for improvement.
A sprint backlog is the subset of product backlog that a team targets to deliver during a sprint to accomplish the sprint goal and progress toward an outcome.
In the context of software development, build refers to the process that converts files and other assets under the developers' responsibility into a software product in its final or consumable form. The build is automated when these steps are repeatable, require no direct human intervention, and can be performed at any time with no information other than what is stored in the source code control repository.
The Given-When-Then formula is a template intended to guide the writing of acceptance tests for a User Story: (Given) some context, (When) some action is carried out, (Then) a particular set of observable consequences should obtain.
A timebox is a previously agreed period of time during which a person or a team works steadily towards completion of some goal.

Help us keep the definitions updated

Ready to join Agile Alliance?

Unlock members-only access to online learning sessions, Agile resources, annual conference discounts, and more! And when you join, you’ll be supporting our member initiatives, regional events, and global community groups.

Privacy Preference Center

IMPORTANT: We have transitioned to a new membership platform. If you have not already done so, you will need to SET UP AN ACCOUNT on the new platform to establish your user profile. Your previous login credentials will not work until you do this set up.

When you see the login screen, choose “Set up Account” and follow the prompts to create your new account. You can choose to log in using your social credentials for either Google or Linkedin (recommended), or you can set up your account using an email address.