# Create a Success Story

This article walks through the steps to create a new success story in PEARS. A success story captures a detailed narrative about the impact of your programming, along with supporting evidence and linked records.

{% hint style="info" %}
**TIP:** The red asterisk **\*** next to the heading of a field indicates that the field is required. Required fields must be completed before you can save the record.
{% endhint %}

{% stepper %}
{% step %}

#### Navigate to Success Stories

From the PEARS homepage, hover over the **Reflect** menu in the top navigation bar and click **Success Stories**.
{% endstep %}

{% step %}

#### Click Add Success Story

On the Success Stories list page, click the **Add Success Story** button to open the success story form.
{% endstep %}

{% step %}

#### Enter a Title

![Screenshot: The top of the success story creation form showing the Title, Reporting Periods, and Program Areas fields](/files/VOarMXUCGrSyn6oYcHn9)

In the **Title** field, enter a descriptive title for this success story.

{% hint style="info" %}
**TIP:** Choose a title that clearly conveys the impact or theme of the story, such as the program name, outcome, or community served.
{% endhint %}
{% endstep %}

{% step %}

#### Select Reporting Periods

In the **Reporting Periods** field, select the reporting period(s) that apply to this success story.
{% endstep %}

{% step %}

#### Select Program Areas

In the **Program Areas** field, select the program area(s) that apply to this success story. At least one program area is required.

{% hint style="warning" %}
**NOTE:** The program areas you select determine whether additional data sections, such as SNAP-Ed data, will be required later in the workflow.
{% endhint %}
{% endstep %}

{% step %}

#### Select a Site (optional)

In the **Site** field, select the site or organization related to this success story. Start typing to search for an available site.
{% endstep %}

{% step %}

#### Select a Unit

In the **Unit** field, select the extension unit associated with this success story.
{% endstep %}

{% step %}

#### Link a Program Activity (optional)

In the **Program Activity** field, select a program activity to link to this success story. Linking a program activity associates the story with a specific direct education record.
{% endstep %}

{% step %}

#### Link Action Plan(s) (optional)

In the **Action Plan(s)** field, select one or more action plans to link to this success story. Linking action plans connects the story to broader planning efforts.
{% endstep %}

{% step %}

#### Add Keywords (optional)

In the **Keywords** field, select one or more keywords to tag this success story. The available keywords are filtered based on your organization.

{% hint style="info" %}
**TIP:** Keywords help categorize and search for success stories across your organization. Use consistent keywords to make stories easier to find later.
{% endhint %}
{% endstep %}

{% step %}

#### Add Uploads (optional)

In the **Uploads** section, attach any relevant files, photos, or documents that support the success story.

If you attach uploads, the **Has Photo Releases** field appears. Select the appropriate option:

* **Not Applicable** — No photos of individuals are included.
* **Yes** — Photo releases have been obtained for all individuals pictured.
* **No** — Photo releases have not been obtained.

{% hint style="warning" %}
**NOTE:** The **Has Photo Releases** field is required when uploads are present. Ensure you have proper photo releases before uploading images that include identifiable individuals.
{% endhint %}
{% endstep %}

{% step %}

#### Add Comments (optional)

In the **Comments** field, enter any additional notes or context about this success story.
{% endstep %}

{% step %}

#### Save and Continue

Click the **Save and Continue** button at the bottom of the form. PEARS saves the success story and takes you to the next step in the workflow: the [Collaborators](/reflect/success-stories/collaborators.md) page.

To save without continuing, click the **Save** button instead.
{% endstep %}
{% endstepper %}


---

# 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/create-a-success-story.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.