> For the complete documentation index, see [llms.txt](https://docs.ngsurvey.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ngsurvey.com/form-management/reports/report-builder/report-items/bar-chart.md).
# Charts
## 📊 What is the chart report item ?
The chart report feature is a powerful tool that enhances your data presentation by enabling you to display information visually through a variety of chart types, including bar charts, pie charts, line charts, and doughnut charts. With these versatile charts, you can effectively illustrate complex data sets, making it easier to understand patterns and trends at a glance. \
\
These charts are particularly useful for showcasing the total number of responses, allowing you to convey quantitative data with clarity and impact. \
\
By selecting the appropriate chart visualization, you can tailor your presentation to highlight specific data relationships and insights. Whether you need to compare categories in a bar chart, show composition with a pie chart, depict trends over time in a line chart, or illustrate proportional relationships in a doughnut chart, the chart report feature provides the flexibility and functionality necessary to make your data accessible and engaging for your audience.
.
{% hint style="warning" %}
This total can be more than the total respondents for multiple choice answers as one respondent can choose multiple different choices on the same question.
{% endhint %}
{% hint style="info" %}
To get a better understanding on multiple choice answers results you may use the [TURF report](/form-management/reports/report-builder/report-items/t.u.r.f.md).
{% endhint %}
The **unique respondents** is the total of respondents who answered this question.
The **form total respondents** is the total of respondents that have participated in the survey.
The **respondent reach** percentage is based on the number of respondents who took the survey and actually answered this question with at least one answer**.**
The **rating** is the average of all the [ratings](/form-management/form-designer/questions/rating.md) of your question's answers.
{% hint style="info" %}
To use the rating feature you must enable the [rating](/form-management/form-designer/questions/rating.md) property on your question properties and set the rating value of your choice for each of the question answers.
{% endhint %}
## 🔅 Chart properties
* **`Linked questions`** are the questions that will be used to generate the charts, each question be rendered as a separate question.
* **`Linked answers`** are the answers that will be used to generate the charts, each answer be rendered as a separate answer.
* **`Breakout question`** is a secondary survey question used to segment and compare the results of a primary question across different respondent groups within the same stacked chart.
* **`Visualization` ** type of chart that should be used to render the results.
* **`Color palette`** that will be used to render bar chart, slices.
* **`Metrics`** used as metrics for the responses rendering.
* **`Respondent count display`** to show or hide the respondents statistics in the chart.
* **`Sort by`** sort order for the bar chart bars.
* **`Group similar`** will use questions which have the same structure (question text, answers) and group and stack them on the same graph. This is especially handy if you're using the [multi-surveys analysis](/data-analytics/multi-surveys-analytics.md) its possible to compare on the same graph results for different surveys on similar questions.
* **`Values`** will show / hide respondents totals for each bar chart.
* **`X/Y axis`** will show / hide the axis on the graph .
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.ngsurvey.com/form-management/reports/report-builder/report-items/bar-chart.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.