Example User Stories

Example User Story – Product Filter

This user story describes the filter functionality used on an eCommerce website. I included three distinct acceptance criteria when writing this; 1 for each of the filter states.

Also to note as the filter functionality is significantly different on desktop and mobile devices I this User Story into two distinct versions. I would normally avoid doing this but as they are so distinct then it is a better option in this example.

Description

As a website shopper, I want to be able to filter the products displayed on the product category page, so that it is easier for me to find a specific product that I want to purchase.

Acceptance Criteria 1

• Given that I am a website shopper viewing the product category page on a desktop device.
• When I select an option in the filter (e.g. Clothing Item > Shirts) on the left hand-side of the screen.
• Then the product category page updates and I am only shown the products that match that category (e.g. Shirts).

Acceptance Criteria 2

• Given that I am a website shopper on the product category page and I have already filtered my results with one option (e.g Shirts).
• When I select an additional option, to narrow my search (e.g. Colour >> Green).
• Then the product category page will be updated and I will I am only shown products that match both options (Shirts that are green).

Acceptance Criteria 3

• Given that I am a website shopper on the product category page and I have already filtered my results with two options (e.g. Shirts + Green).
• When I remove one of these selections, to open-up my search.
• Then the product category page will be updated and I will I be shown all shirts (not just green one’s.

Example User Story – Viewing a profile

This user story described what a user would see depending on the state of their profile (i.e., The Pets they had and the the number of medication reminders per pet.

As an authenticated user with one or more pet profiles vising the dashboard page I want to see my Pet Profile Card snippets showing me the pet name and their current reminders, so that I can clearly understand what has been set-up.

Acceptance Criteria #1

• Given I am an authenticated user on the dashboard page with one or more pet profiles
• When I look at a Pet profile card snippet that has associated reminders
• Then I will see the following fields:
• Pet icon
• Pet name
• Product reminder
• Dose day [label]
• Product reminder dose day(s) (mm/dd/yyyy)- a maximum of 3 reminder dates will be shown, based on the date they were last created/edited. If a specific pet has more than three medication reminders set-up, then the the 4th or more oldest one’s will not be displayed.
• View full pet profile button

Acceptance Criteria #2

• Given I am an authenticated user on the dashboard page with one or more pet profiles.
• When I look at a Pet profile card snippet that has NO associated reminders
• Then I will see the following fields:
• Pet icon
• Pet name
• Message to set up a reminder
• Add a reminder button (Ghost button)
• View full pet profile button

Acceptance Criteria #3

• Given I am looking at the Pet Profile Card snippet
• When I click on the view ‘full pet profile button’
• Then I will be taken to the full pet profile for that pet

Acceptance Criteria #4

• Given I am looking at the Pet Profile Card snippet for a Pet WITHOUT reminders
• When I click on the add a reminder button
• Then the add create reminder modal overlay will be opened.

Example User Story – Location Pin

As a Website User, I want to be able to understand when the distributor in my home country is located in another country so that I am not confused when I see a foreign address.

Acceptance Criteria #1

• Given that I am on the sites and distributors map
• When I click on the info window for Spain
• Then I see a field under the main address telling me ‘the distributor for Spain is based in Italy’

Acceptance Criteria #2

• Given that I am on the sites and distributors table
• When I filter on ‘Spain’ in the country dropdown
• Then I see a field under the main address telling me ‘the distributor for Spain is based in Italy’

As a CMS Editor, I want to be able to add an additional text field called ‘Location Information’ to the Worldwide sites – Distributors widget – where I can add free form text ‘the distributor for Spain is based in Italy’