Skip to main content

User Stories

User Stories are concise descriptions of features from an end-user perspective. TestFlair's AI automatically generates user stories from your project data (uploaded files and text context).

What Are User Stories?​

A user story follows the standard format:

As a [type of user], I want [an action] so that [a benefit/value]

For example:

As a registered customer, I want to reset my password so that I can regain access to my account if I forget it.

Generating User Stories​

After uploading your project data:

  1. Navigate to the User Stories tab in your project
  2. Click Generate User Stories
  3. Wait for the AI to analyze your requirements
  4. Review the generated stories

Generate user stories

The AI extracts user scenarios, features, and requirements from your uploaded documents and text context, then converts them into well-structured user stories.

tip

The quality of generated user stories depends directly on the clarity and detail of your uploaded requirements. See Project Data for tips on improving input quality.

Understanding Generated Stories​

Each generated user story includes:

FieldDescription
TitleBrief description of the feature
User StoryThe formatted story statement
Acceptance CriteriaConditions for story completion

Acceptance Criteria​

Each story comes with acceptance criteria defining when the story is "done":

Given [precondition]
When [action]
Then [expected result]

Example:

Given I am on the login page
When I click "Forgot Password" and enter my email
Then I should receive a password reset link within 5 minutes

Sample Generated User Story​

Here is an example of what the AI generates from a BRD about an e-commerce application:

Title: User Password Reset

User Story: As a registered customer, I want to reset my password so that I can regain access to my account if I forget it.

Acceptance Criteria:

  • Given I am on the login page, when I click "Forgot Password" and enter my registered email, then I should receive a password reset link within 5 minutes
  • Given I have received a reset link, when I click it and enter a new valid password, then my password should be updated and I should be redirected to the login page
  • Given I enter an unregistered email, when I submit the forgot password form, then I should see an error message indicating the email is not found

Browsing, Searching & Filtering​

User stories are organized by feature. Use the feature tabs to filter stories by a specific feature, or select All to see every story.

You can also search the list — start typing to match across a story's code, title, goal, and feature name, and the matching stories filter instantly.

User stories list with feature tabs

Editing User Stories​

  1. Click on any user story to open it
  2. Modify the title, description, or acceptance criteria
  3. Save your changes

Edit user story

Adding a New User Story​

To manually add a user story:

  1. Click the Add button
  2. Fill in the user story details
  3. Save the story

Importing Existing User Stories​

If you already have user stories written in a document or spreadsheet, you can import them verbatim instead of generating them — see User Story Import.

Beta feature

Direct import is a Beta feature and may not be visible on every account.

Troubleshooting​

Low-quality stories?

  • Improve your uploaded requirements with more detail
  • Add specific user scenarios and flows
  • Include validation rules and error scenarios in your project data

Exporting User Stories​

Export your user stories to an Excel spreadsheet for external sharing or review:

  1. From the user stories view, click the Export button
  2. A .xlsx file is downloaded containing all user stories with their details and acceptance criteria

Next Steps​

With user stories generated:

  • Test Cases — Generate test cases from your user stories
  • Project Data — Improve your requirements for better stories