# Success Stories

A **Success Story** in PEARS captures a detailed narrative about the impact of your programming. Each success story documents the background, outcomes, and significance of a program or project, along with supporting evidence such as photos, quotes, and linked records. Use this module to showcase how your work makes a difference in the communities you serve.

## Getting Started

To access Success Stories, hover over the **Reflect** menu in the top navigation bar and click **Success Stories**. The Success Stories list displays all of your records, with options to search, filter, sort, and create new entries.

![Screenshot: The Success Stories list page showing the table of records with columns for title, reporting period, program area, completion status, and noteworthy star icon, along with search and filter controls at the top](https://2560412328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff0820LrBGQ9ZA8SC4BR1%2Fuploads%2Fgit-blob-0bab7fadfbe7bf81609a77fa7fcb6f2f5c66b587%2Fsuccess-stories-list.png?alt=media)

## Workflow

Creating a complete success story record involves several steps. PEARS guides you through each section in order:

{% stepper %}
{% step %}

#### General Information

Enter the story title, reporting periods, program areas, site, unit, and other basic information.

[Create a Success Story](https://support.pears.io/reflect/success-stories/create-a-success-story)
{% endstep %}

{% step %}

#### Collaborators

Add other PEARS users who contributed to or should have access to this success story.

[Collaborators](https://support.pears.io/reflect/success-stories/collaborators)
{% endstep %}

{% step %}

#### Partners (if applicable)

If the partnerships feature is enabled for your organization, add any partners associated with this success story.
{% endstep %}

{% step %}

#### Custom Data (if applicable)

If your organization has custom data sections configured, complete the required custom data fields.
{% endstep %}

{% step %}

#### Story Narrative

Write the background, body narrative, and an optional favorite quote to tell the story of your program's impact.

[Story Narrative](https://support.pears.io/reflect/success-stories/story-narrative)
{% endstep %}

{% step %}

#### SNAP-Ed Data (if applicable)

If your organization uses SNAP-Ed, complete the SNAP-Ed data section including project, priority indicators, frameworks, and approaches.

[Add SNAP-Ed Data](https://support.pears.io/reflect/success-stories/add-snap-ed-data)
{% endstep %}

{% step %}

#### Mark as Complete

Once all required sections are finished, mark the success story as complete.

[Mark a Success Story as Complete](https://support.pears.io/reflect/success-stories/mark-a-success-story-as-complete)
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**TIP:** The **Program Progress** panel on the right side of the success story detail page shows your completion percentage and a checklist of remaining sections.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.pears.io/reflect/success-stories.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.