# Customizable Widgets

In this article we'll go over details on how to create a Widget.

There are 2 places you can add Reports

* [Team metrics](https://delivery.usehaystack.io/team/metrics) (check Learn how to use Team metrics article)
* [Reports](https://delivery.usehaystack.io/reports) (check Learn how to use Reports article)

Below are all the ways you can create a new report.

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

{% hint style="info" %}
Read more on [Team Reports](https://help.usehaystack.io/features/team-metrics) & [Flexible Reports](https://help.usehaystack.io/features/flexible-reports)
{% endhint %}

## Report Widget <a href="#h_bd03ca526c" id="h_bd03ca526c"></a>

A report consists of 2 high level parts

* Data
* Visualization

We'll go each of below.

### Select metric <a href="#h_702f947474" id="h_702f947474"></a>

Metric section is the basis of any graph.

There are 4 types of entities

* Sprint
* Issue
* Pull Request
* Deployments

Based on which time of entity you selected, all the options underneath from calculation method to filter options will change.

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

{% hint style="info" %}
To see every metric in detail check [all metrics](https://help.usehaystack.io/features/list-of-all-metrics).
{% endhint %}

### Select calculation method <a href="#h_b1098f4b64" id="h_b1098f4b64"></a>

Calculation method is the aggregation function used to graph.

There are 3 options

* Average
* 85th Percentile
* Total

If the metric has only one time of calculation method supported, this field will show empty.

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

### Select group by <a href="#h_0361ee70c1" id="h_0361ee70c1"></a>

Group by allows you to see divide the calculation into multiple buckets.

Group by options changes depending on the [base metric entity type](#h_702f947474) being Sprint, Issue, Pull Request or Deployments.

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

### Select teams <a href="#h_3c2b9d10fa" id="h_3c2b9d10fa"></a>

Teams section does the same thing as [filters section](#h_f37da24533). It's a hyper specific filter that's put into front for easier usage.

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/1018310152/3f1ccbcfcd34098cd664fad1/Screen+Shot+2024-04-11+at+11_32_56+AM.png" alt=""><figcaption></figcaption></figure>

**Note:**

* Reports created in [Team metrics](https://delivery.usehaystack.io/team/metrics) does not support Teams filter. It automatically selects the selected team.

### Select filters <a href="#h_f37da24533" id="h_f37da24533"></a>

Allows you to filter the data.

Filter options changes depending on the [base metric entity type](#h_702f947474) being Sprint, Issue, Pull Request or Deployments.

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

Note:

* Filter only supports "filtering in".
* It does not support "filtering out".

### Select visualization (Graph type) <a href="#h_950548324d" id="h_950548324d"></a>

You can visualize your reports in different ways.

The following options are supported

* Line
* Area
* Bar
* Stacked bar
* Value

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

### Select timeframe <a href="#h_f9bf6e45a8" id="h_f9bf6e45a8"></a>

Time frame or date filter is a specialised [filter](#h_f37da24533) that filter-in only the entities that were in the given time frame.

It also changes the xAxis for Line & Area charts.

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

### Select graph ticks <a href="#h_a0f4f00a8c" id="h_a0f4f00a8c"></a>

Supports 3 options

* By week
* By month
* By quarter

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

This dropdown does 2 different work depending on the visualization type

* For Line and Area visualization types it changes the graph tick.
* For Bar, Stacked Bar and Value visualization types it runs the calculation method `per week/month/quarter` .

Example:

* [Issue completed per week - Line Chart](https://cdn.zappy.app/346ac4ad338d0f3af8b66d067a9c18b6.png)
  * Gives each week one by one
* [Issue completed per week - Value Chart](https://cdn.zappy.app/f812efa7811ea9838fd3d02fa8291f8b.png)
  * Gives the average across all weeks

### Trend Line (optional) <a href="#h_a5c3a291fe" id="h_a5c3a291fe"></a>

The trendline option is only available for Line chart visaulization.

You can enable or disable it.

Trendline uses [Linear Regression](https://en.wikipedia.org/wiki/Linear_regression).

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

## Note Widget <a href="#h_d51e7ec7ae" id="h_d51e7ec7ae"></a>

You can create a note widget which supports richtext formats.

<figure><img src="https://downloads.intercomcdn.com/i/o/1021925044/3b9a9d9eddf106c633c3619a/Screen+Shot+2024-04-15+at+4_16_47+PM.png" alt=""><figcaption></figcaption></figure>

***

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

### Is vertical stacked bar chart supported? <a href="#h_33a10b82b2" id="h_33a10b82b2"></a>

No.

Vertical stacked bar has xAxis is time, yAxis is metric.

The same visualization type can be achieved using Area Chart. To simplify the options, we do not support vertical stacked bar chart.

### How does the reports handle duplicate data? <a href="#h_cef412e323" id="h_cef412e323"></a>

Reports work in the following manner

1. Get raw data
2. Make raw data unique
3. Calculate metric

This process ensures no data is counted twice, regardless of what filter you select.

### Can I filter out data from the metrics? <a href="#h_408813604c" id="h_408813604c"></a>

No. Haystack only supports filter-in option.

### Do you track X metric? <a href="#h_c0d5879105" id="h_c0d5879105"></a>

See this page for a list of [all metrics](https://help.usehaystack.io/features/list-of-all-metrics) and calculations.

### How is X metric calculated? <a href="#h_532b1dde91" id="h_532b1dde91"></a>

See this page for a list of [all metrics](https://help.usehaystack.io/features/list-of-all-metrics) and calculations.

<br>
