# Metrics

IN THIS ARTICLE

With metrics, users can track progress toward implementation goals. This article examines the process for adding and tracking progress toward stated outcomes.

***

## Metrics

In FieldDoc, each activity record can have associated metrics. There are two types of metrics. Automated metrics [model ](/essentials/model-outputs.md)outcomes. Manual metrics can be attached to activity records from curated lists. The most common lists are associated with a [pact](/essentials/pacts.md). This flexibility expands what you can analyze, measure, and report through the system. Because FieldDoc standardizes data across every component, you can track metrics at any scale—from a single project, to an organization-wide initiative, to participation in a funding program that spans many partners.

Let’s take a closer look at the manual metrics. 

{% hint style="info" %}
**Looking to calculate modeled metrics?** To look closer at how modeled metrics are managed, start [here](/essentials/activities/models.md). 
{% endhint %}

### \`Planned\_Values\` & \`Implemented\_Values\`

Non-modeled metrics each have two input fields: `planned_value` and `implemented_value`. These values track both the goal and the progress toward that goal. Inputs to each field are manually entered by FieldDoc users.

#### Edit activity modal view of metrics

<figure><img src="/files/5UaX1ZFKSwX3g9TDc7N9" alt="" width="563"><figcaption></figcaption></figure>

#### Overview view of metrics

<figure><img src="/files/k5S5PKtxcZSvnKRsVQ4b" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="175.625">Field</th><th>Description</th><th>Details</th></tr></thead><tbody><tr><td>'planned_value' </td><td>The proposed outcome, or target goal, that will be achieved at the end of the performance period.</td><td>This is a number field. This field is typically set when a record is created and remains the same. </td></tr><tr><td>'implemented_value`</td><td>The amount implemented to date.</td><td>This is a number field. This field is typically updated during reporting periods, with the final implementation report displaying the final implemented value.</td></tr></tbody></table>

## Enter your metric values

Metrics can be entered from within an activity record or from table views within *Project folders* or *Pacts.* Both options have benefits, and our team recommends choosing the pathway that you feel most comfortable with using.

{% tabs %}
{% tab title="Enter within activity records" %}

### Step-by-step instructions

1. Open an activity record's **Edit Activity** modal.
2. Navigate to the **Metrics** tab.
3. Under **Programmatic Metrics**, select the **Pact** within which you want to add **Metrics**.
4. Click **+ Add Metrics**. A list of all metrics associated with the Pact appears.
5. Select all metrics that you want to add to the record. You must enter in a `planned_value` into the provided field in order to the metric to save.
6. All selected metrics will appear in the metrics view with their `planned_value`.&#x20;

### Dig-In! Hands-on tutorial to add metrics via *Edit Activity* modal

{% @arcade/embed flowId="xuY3LhzHoUd5vv7U7rnc" url="<https://app.arcade.software/share/xuY3LhzHoUd5vv7U7rnc>" %}
{% endtab %}

{% tab title="Enter within table views" %}

### Step-by-step instructions to add a metrics via table view

These instructions are designed for users working within a **Pact view**.

Once you have added all of your activities to your Pact, follow the steps below to enter planned metrics using the **Metrics** tab:

1. **Navigate to the Metrics Tab**\
   Open your Pact and click on the **Metrics** tab. This will display the metrics table view.
2. **Add a New Row**\
   Click **“+ Add Row”** to begin entering metrics.
3. **Select the Activity**\
   In the first column, choose the corresponding **Activity** from the dropdown. Each row should be tied to **one activity**.
4. **Select the Metric**\
   In the next column, use the dropdown to select the **specific metric** you want to track for that activity. Each row should include **only one metric**.
5. **Enter the Planned Value**\
   Input the **planned value** (numeric) in the appropriate field. This represents the amount you plan to implement for that metric.
6. **Add Additional Metrics**\
   If an activity includes multiple metrics, click **“+ Add Row”** again and repeat steps 3–5. Use the same activity, but select a different metric for each additional row.
7. **Add Metrics for Other Activities**\
   Repeat the process for each additional activity in your Pact.

> 💡 *Tip: Each row in the metrics table should represent a single activity/metric pair. This structure ensures your metrics are clearly linked to specific implementation activities.*

### Dig in! Hands on tutorial for entering metrics and planned values from the *Pact Metric table view*&#x20;

{% @arcade/embed flowId="mEsJpoKJI0asMgM8RT0U" url="<https://app.arcade.software/share/mEsJpoKJI0asMgM8RT0U>" %}
{% endtab %}
{% endtabs %}

## Enter implementation progress for metric values for reporting

{% tabs %}
{% tab title="Enter within activity record" %}

### Step-by-step instructions

1. Open an activity record's **Edit Activity** modal.
2. Navigate to the **Metrics** tab.
3. Under **Programmatic Metrics**, select the **Pact** within which you want to add **Metrics**.
4. Click  the ellipses next to the metric that you want to update. A pop up with `planned_value` and `implemented_value` fields appears.
5. Enter in the `implemented_value`. Click Save.
6. The saved metrics will appear in the metrics view with their `planned_value`.  The progress will be displayed in the grid view and rolled up within all overview dashboards.

### Dig in! Step-by-step tutorial for reporting implementation via *Edit Activity* modal

{% @arcade/embed flowId="kDnOXA54D0PAk2ylTOv9" url="<https://app.arcade.software/share/kDnOXA54D0PAk2ylTOv9>" %}
{% endtab %}

{% tab title="Enter within table views" %}

### Step-by-step instructions to add a metrics via table view

These instructions are designed for users working within a **Pact view**.

Once you have added all of your activities to your Pact, follow the steps below to enter planned metrics using the **Metrics** tab:

1. **Navigate to the Metrics Tab**\
   Click on the **Metrics** tab. This will display the metrics table view.
2. **Find the activity and metric that you want to add or update an implementation value.**\
   Each metric will have its own row, meaning that you may see multiple rows for each activity.
3. **Enter in the \`implemented\_value\`** \
   Values must be numeric.&#x20;
4. **Repeat.**

### Dig in! Hands on tutorial for reporting implemented\_value via *pact table views*

{% @arcade/embed flowId="uxTLfnwuowdVzFYPa6dh" url="<https://app.arcade.software/share/uxTLfnwuowdVzFYPa6dh>" %}
{% endtab %}
{% endtabs %}

## Types of non-automated metrics

### Organizational Metrics (*standard plan*)

Standard users can create a custom list of metrics that are important to their organization. After making this list, you can set targets for each metric. These targets will show up in the organization view.

As you add activity records to your portfolio, you can link them to your organization’s metrics. During the project timeline, you can track your progress toward each goal at the activity level. That progress is then added up and shown at higher levels—like Section, Project, and Organization views.

For example, if an activity is part of a Section and a Project, its contribution to a metric will count toward the totals for the Section, the Project, and the Organization. This makes it much easier to track and share progress on big goals, like the number of trees planted or the number of miles of stream restored.

There is a lot of information to explore on how to set up and track your metrics.

:seedling: Learn More: [Metrics - Organization](/essentials/metrics/metrics-organization.md)

### Programmatic Metrics (*all plans*)

Program Managers can create a custom list of metrics that are important to their funding program and organization. After making the list, any user that has assigned activity records to a Pact in that Funding Program can add the metrics to their activity record and set a target outcome. The targets will show up in the Pact Overview view.&#x20;

As grantees progress in their work to meet their funding requirements, they can track progress toward implementation for the programmatic metrics within their activity record. That progress is added up and shown on the Pact overview page. All of the Pacts within a Funding Opportunity will roll up and provide an overview of progress toward larger goals, such as Blueprints or Business Plans, for an entire funding program. The process allows Funding Program Managers to:

* Align their priorities with individual awards
* Track the geospatial and quantitative impact from standard views
* Track implementation progress and measure progress toward program goals through a verifiable source.

:seedling: Learn More: [Metrics - Programmatic](/essentials/metrics/metrics-programmatic.md)


---

# 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://help.fielddoc.org/essentials/metrics.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.