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.

We’re working on a new version of tech.gsa.gov

We’re adding tools to help GSA deliver a digital-first public experience. You can track our progress in our open-source repository.

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