Skip to main content
U.S. flag

An official website of the United States government

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock () or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

User Story Examples

When Writing Effective User Stories, it is important to have descriptive summaries and detailed acceptance criteria to help the Team know when a user story is considered complete or “done.” See the examples below:
Epic User Story Acceptance Criteria
As an Acquisition Gateway User, I need to access the Acquisition ordering platform behind a secure login so that I can purchase products. As an Acquisition Gateway User, I need to select an Auction product in the Acquisition ordering platform so that I can bid on it. Ensure the Acquisition Gateway User is able to:

  • log in to Acquisition Gateway
  • navigate to the Auction page
  • able to select a product(s) to bid on
As an Acquisition Gateway User, I need to review my previous bids in the Acquisition ordering platform so that I can remove expired bids. Ensure the Acquisition Gateway User is able to:

  • log in to Acquisition Gateway
  • navigate to a page to review items previously bid upon
  • select one, or multiple, expired bids
  • remove expired bids
As a Marketing Lead, I want to have a content management system so that I can manage and provide quality content and experience to my readers.


Source: How to Use User Stories to Build Your Website
As a Content Owner, I want to be able to create product content so that I can provide information and market to customers. Ensure the Content Owner is able to:

  • log in to the content management system
  • create a page of content
  • edit / update an existing page of content
  • save changes
  • assign content page to Editor for review
As an Editor, I want to review content before it is published so that I can assure it is optimized with correct grammar and tone. Ensure the Editor is able to:

  • log in to the content management system
  • view existing content page
  • edit / update page of content
  • add markup comments- save changes
  • save changes
  • re-assign to Content Owner to make updates
  • schedule content publish
As an EBC Requester, I want to create an executive business case so that I can request funding for a project. As an EBC Requester, I want to know what catalog of services GSA IT offers so that I can determine if an existing platform can support my proposed project. Ensure the EBC Requester is able to:

  • receive / access a catalog of GSA IT services
  • able to easily compare platform technologies and identify associated costs
As an EBC Requester, I want to have a checklist of outputs so that I can submit a complete EBC request. Ensure the EBC Requester is able to:

  • receive / access an EBC Checklist
  • has access to submit the EBC in Salesforce
  • can create / view / edit all of the applicable sections and materials required to submit the EBC
As a HR Manager, I want a virtual job openings board so that I can view job status and manage company personnel needs.


Source: How Does Agile Marketing Work?
As a HR Manager, I need to view a candidate’s status so that I can manage their application process throughout the recruiting phases. Ensure the HR Manager is able to:

  • log in to the virtual job openings board system
  • view / edit / add the status for job candidates
  • update for each phase (e.g. Phone Screening Completed, In-person Interview Scheduled, Background Check in-progress, etc.)
  • send email communication to staff regarding candidate
As a Marketing Data Analyst, I want to create forecast and trend reports so that I can support the sales efforts of Region 9 Marketing Representatives.



Source: How Does Agile Marketing Work?
As a Marketing Data Analyst, I need to run the Salesforce & Google analytics reports the so that I can build the monthly media campaign plans. Ensure the Marketing Data Analyst is able to:

  • access the Salesforce & Google Analytics reports
  • create the monthly media campaign plan for a specified region (e.g. Region 9)
  • access a Contacts list
  • email the prepared monthly media campaign to one or more selected contact(s)

tech.gsa.gov / Office of the CTO

An official website of the U.S. General Services Administration

Looking for U.S. government information and services?
Visit USA.gov