# Flexible Reports

{% hint style="info" %}
Looking to report team specific metrics? Checkout [Team Reports](/features/team-metrics.md).
{% endhint %}

[Reports page](https://delivery.usehaystack.io/reports), gives a you ability to create custom boards for different use cases.

Below we'll learn how to use Reports page.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018877601/68370fef70316ec62e939938/Screen+Shot+2024-04-11+at+8_04_01+PM.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Check [all metrics Haystack supports](/features/list-of-all-metrics.md)
{% endhint %}

Boards are a layer on top of graphs allowing you to have multiple graphs in a single view.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018879694/bd61b14e341160fe8649d7f2/Screen+Shot+2024-04-11+at+8_06_30+PM.png" alt=""><figcaption></figcaption></figure>

## Create Boards <a href="#h_d266befc2f" id="h_d266befc2f"></a>

You can create a new board using the "Add new board" buttons.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018878407/73e0d75792d493e3ea403d59/Screen+Shot+2024-04-11+at+8_05_10+PM.png" alt=""><figcaption></figcaption></figure>

You will see 2 options

1. Blank report
2. [Templates](/features/flexible-reports.md)

<figure><img src="https://downloads.intercomcdn.com/i/o/1018881159/934ff5b92a4af96e7d4389ee/Screen+Shot+2024-04-11+at+8_07_52+PM.png" alt=""><figcaption></figcaption></figure>

Templates are a set of pre-defined reports combined into a single board.

\
The following templates are available

* **Operational Health Metrics**: Track metrics that every software team should have eyes on
* **Team Health**: Understand how your teams are working
* **Delivery Lifecycle**: Understand issue lifecycle and where to focus
* **Code Review Lifecycle**: Understand code review lifecycle and where to focus

Once you have selected your template you can click "Use template" to create the board.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018884287/8cbc4c8322b26ab3a4fd614b/Screen+Shot+2024-04-11+at+8_10_41+PM.png" alt=""><figcaption></figcaption></figure>

**Note**:

* You can always delete any board. Feel free to test what you are looking for.

## Edit Board <a href="#h_af6a40274c" id="h_af6a40274c"></a>

### Add Widget <a href="#h_bbebbb3f0a" id="h_bbebbb3f0a"></a>

{% hint style="info" %}
Read more on [Customizable Widgets](/features/team-metrics.md)
{% endhint %}

You can add a new Widget in 2 ways

1. **Add Report Button**
2. **Add Content Button**

<figure><img src="https://downloads.intercomcdn.com/i/o/1018271794/d8e79d218e47d074bd7075d1/Screen+Shot+2024-04-11+at+10_50_07+AM.png" alt=""><figcaption></figcaption></figure>

Once you click on them, you'll see 2 options

1. **Report widget**: Adds flexible reports
2. **Note widget**: Notepad that supports richtext editor.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018274713/559622694b1a1318538c70d3/Screen+Shot+2024-04-11+at+10_53_24+AM.png" alt=""><figcaption></figcaption></figure>

Below is an example how both are being used together.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018274532/bab896fa13496e0e69e9759d/Screen+Shot+2024-04-11+at+10_53_07+AM.png" alt=""><figcaption></figcaption></figure>

### Update Report Order <a href="#h_264eb61f30" id="h_264eb61f30"></a>

If you hover over any content you'll see 3 lines logo. Holding this will allow you to rearrange the order of the graphs

<figure><img src="https://downloads.intercomcdn.com/i/o/1018280610/e712f36f64e91f42c0742d35/Screen+Shot+2024-04-11+at+11_00_17+AM.png" alt=""><figcaption></figcaption></figure>

### Update Filters <a href="#h_4713982011" id="h_4713982011"></a>

Filters allow you to quickly set common filter types across all graphs in that board with ease.

You need to press "Save" button for the filters to take action. Once saved, all the graphs respective filters will be updated individually.

### Update Date Filter <a href="#h_c3a43f7c6f" id="h_c3a43f7c6f"></a>

Easily filter all boards using your selected date range.

Alternatively, you can make the 'End Date' dynamic in your reports by setting a fixed 'Start Date' (e.g., January 1st). The 'End Date' will automatically adjust to always reflect today's date.

To Enable Dynamic Date Filtering:

1. &#x20;Locate the 'Since' slider button in date filter settings.
2. Toggle the slider to enable the feature.
3. Set your desired 'Start Date' as input.

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

**Note**:

* Default - the board will show each graphs original date filter supporting different time ranges being shown in a single board.
* You cannot filter earlier than 12 months. Contact us at <support@usehaystack.io> if you are looking to get more access.

### Update Team Filter <a href="#h_6bee25c9c2" id="h_6bee25c9c2"></a>

You can quickly filter all boards to teams you have selected.\
​

Once you open the dropdown you will see 2 sections

* My subscribed teams: Any team you see in your left sidebar are your subscribed teams.
* Other teams: Any team that you have not subscribed.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018903587/bb57226d3f13339260589e90/Screen+Shot+2024-04-11+at+8_28_59+PM.png" alt=""><figcaption></figcaption></figure>

**Note**: Default - the board will show each graphs original team filter supporting supporting different teams being shown in a single board.

### Update board name <a href="#h_aaf39be08c" id="h_aaf39be08c"></a>

You can change a boards name & their description.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018885522/af5989a8664e0e3267736a78/Screen+Shot+2024-04-11+at+8_12_12+PM.png" alt=""><figcaption></figcaption></figure>

### Update access permissions <a href="#h_0e423dca52" id="h_0e423dca52"></a>

You can change the access of each board to either

* **Public**: Everyone who has access to Haystack will be see the board in the "All boards" list
* **Private**: Only you can see private boards.

<figure><img src="https://haystack-cf20ab244ac6.intercom-attachments-1.com/i/o/1018908000/1efa20a53cacf398b7148e85/d029ba8d13c086ba6884fd980f2f82b4.png" alt=""><figcaption></figcaption></figure>

### Add to Favorites <a href="#h_e7e745bdc4" id="h_e7e745bdc4"></a>

You can set

* any public board
* your private boards

as your favorite board.

Once you have at least 1 favorite board, on the sidebar "Favorites" section will appear .

<figure><img src="https://downloads.intercomcdn.com/i/o/1018889511/9753fd833f23d38a523a4d0c/Screen+Shot+2024-04-11+at+8_16_02+PM.png" alt=""><figcaption></figcaption></figure>

You can also set favorite boards by hovering over All boards list.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018890516/0bf5b67229cbe41bce9a9332/Screen+Shot+2024-04-11+at+8_16_36+PM.png" alt=""><figcaption></figcaption></figure>

## Duplicate Board <a href="#h_0f71700366" id="h_0f71700366"></a>

Duplicating a board will copy everything including all the boards underneath as a new board.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018896374/5a84e2121c1b4385b2bf09ce/Screen+Shot+2024-04-11+at+8_21_53+PM.png" alt=""><figcaption></figcaption></figure>

## Delete Board <a href="#h_b348cf509c" id="h_b348cf509c"></a>

Deleting a board will delete everything related with that board. Anyone who has access to the board or has it as favorite will lose that access.

This action is not reversible.

<figure><img src="https://downloads.intercomcdn.com/i/o/1018897555/af026dd3f61828ba7a9d39ad/Screen+Shot+2024-04-11+at+8_22_55+PM.png" alt=""><figcaption></figcaption></figure>

## Share Board <a href="#h_990731919e" id="h_990731919e"></a>

You can share the whole board with a few clicks.

The following options are supported

* **Export as CSV**: Shares each boards data in CSV format.
* **Export as PNG**: Takes a screenshot of the board in png format.
* **Copy Link**: Shares the board link. You can also share the link from the browser.
  * *When sharing a board, make sure that the board* [*permission*](/features/flexible-reports.md) *is set as "public".*
  * *Only people who has access to Haystack can see the shared links*

<figure><img src="https://downloads.intercomcdn.com/i/o/1018898799/94bb4fcdddb5fd1618d57f81/Screen+Shot+2024-04-11+at+8_24_03+PM.png" alt=""><figcaption></figcaption></figure>

## Examples <a href="#h_ee665dbe64" id="h_ee665dbe64"></a>

### Operational Metrics Board <a href="#h_df4aba3534" id="h_df4aba3534"></a>

You can read more on [First Principles of Engineering Metrics](https://www.notion.so/usehaystack/First-Principles-of-Engineering-Metrics-1b4ae891164144fcb8c04a264849a3c3?pvs=4)

**Speed:**

* Issue Cycle Time
* Issue Completed

**Quality:**

* Issue Lead Time
  * filter by bugs
* Issue Completed
  * filter by bugs

**Predictability:**

* Sprint Predictability Rate
* Issue Completed
  * group by Investments

<figure><img src="https://cdn.zappy.app/5a2b89be32a8edf903e12abffac68b85.png" alt=""><figcaption></figcaption></figure>

### Quality Board <a href="#h_a39124871c" id="h_a39124871c"></a>

You can read more on [How to Improve Quality](https://www.notion.so/usehaystack/Quality-for-Product-Engineering-Teams-13a9f9ec734a4f179b786fcaf7310bc5?pvs=4).

**Main Metrics**

* Issue Lead Time
  * filter by bugs
* Issue Completed
  * filter by bugs

**Debugging Metrics**

* Issue Lead Time
  * group by teams
  * filter by bugs
* Issues Completed
  * group by teams
  * filter by bugs
* Issue Lead Time
  * group by priority
  * filter by bugs
* Issues Completed
  * group by priority
  * filter by bugs

<figure><img src="https://cdn.zappy.app/1b226595bef1ba5984ccd2824424045c.png" alt=""><figcaption></figcaption></figure>

### Estimation Accuracy <a href="#h_1bfff5943a" id="h_1bfff5943a"></a>

**Main Metrics**

* Sprint Predictability Rate

**Debugging Metrics**

* Issues Completed
  * Group by Investments
* Issue Cycle Time
  * Group by Story points
* Issues Injected
* PRs unlinked

<figure><img src="https://cdn.zappy.app/394daf39db3392760ca6e2cf2b98aa23.png" alt=""><figcaption></figcaption></figure>

## FAQ <a href="#h_da76500108" id="h_da76500108"></a>

<details>

<summary>What’s the difference between Team Metrics and Reports pages?</summary>

[Team metrics](https://delivery.usehaystack.io/team/metrics) is purposefully built for a single team. This gives teams a dedicated place to review metrics that are most relevant to that particular team.

[Reports](https://delivery.usehaystack.io/reports) provides flexible reporting across all teams.

</details>

<details>

<summary>Do you track X metric?</summary>

See this page for a list of [all metrics](/features/list-of-all-metrics.md) and calculations.

</details>

<details>

<summary>How is X metric calculated?</summary>

See this page for a list of [all metrics](/features/list-of-all-metrics.md) and calculations.

</details>

<details>

<summary>Can I see this per X?</summary>

Yes, most likely.

You can group by any field in Github or Jira. For Github Metrics (i.e. Review Time, PRs Merged, etc) you’ll be able to group by any field in Github. Similarly for Jira Metrics (i.e. Cycle Time, Sprint Completion, etc) you’ll be able to group by any field in Jira.

For more info check [Add Reports](/features/customizable-widgets.md)

</details>

<details>

<summary>Can I filter to only contain X?</summary>

Yes, most likely.

You can filter by any field in Github or Jira. For Github Metrics (i.e. Review Time, PRs Merged, etc) you’ll be able to filter by any field in Github. Similarly for Jira Metrics (i.e. Cycle Time, Sprint Completion, etc) you’ll be able to filter by any field in Jira.

For more info check [Add Reports](/features/customizable-widgets.md)

</details>

<details>

<summary>What reports should I track?</summary>

See this page for a list of all our favorite boards.

</details>

<details>

<summary>Can I duplicate an existing board?</summary>

You can duplicate an existing board only in [Reports](https://delivery.usehaystack.io/reports) page.

In [Team metrics](https://delivery.usehaystack.io/team/metrics) page, you cannot duplicate or copy a board from one team to another.

</details>

<details>

<summary>Can I update all reports on a board?</summary>

Yes, simply update the [filter](#h_4713982011) at the top of any board. This will filter all reports on that board. You can additionally save your filter if you’d like to change the board’s default filters.

</details>


---

# 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.usehaystack.io/features/flexible-reports.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.
