PDF: Bar Chart

Add a Bar Chart widget to your customized report to show respondent's results or another data set at a glance. A Bar Chart displays your data with rectangular bars.

Essential  ✗
Professional  ✗
ReportR ✓

With Bar charts, you can show data separated into categories with relative numbers. Here's an example of a Bar chart:

ReportR: bar chart example

This guide will discuss:

  1. Setting up the widget
  2. Widget logic rules
  3. Other available widgets

1 Setting up the widget

Let's go! Start by adding a Chart Title which will be displayed at the top of the bar chart.

bar chart- chart items

1.1 Bar Chart data

Then it's time to get into the details of the chart:

ReportR bar chart metrics

  1. Dimension name - this is the legend that will be displayed underneath the bar chart describing what each bar is showing.
  2. Metric name - the name that will be displayed on the left-hand side of the chart, labeling the bar. This name should describe the category the bar is displaying, for example, different topics or areas of skills.
  3. Metric color - click on the pencil icon to access the color selector and choose what color each bar should be. You can make all bars the same color, or choose a different shade for each bar.
  4. Metric value - for each bar, choose which value should be displayed. Use the drop-down list to select one of the Variables. If you have, for example, created question blocks with questions on 3 different topics, the first metric value might be the score for question block 1.
  5. Add Metric - click here to add another bar to be shown on the chart. Each metric displays one bar on the chart, and you can add as many as you need. If you have made a few question blocks, you may want to add a metric so that a bar will be displayed showing scores achieved for each question block.


If you change your variable data, you must collect a new response in order to preview your chart.

Tip: You can also add negative values into your dimension metrics as shown below.

negative metric values - bar chart

1.2 Bar chart settings

Once you've set up the bars, give your bar chart a widget name and chart title. Then, you can adjust a number of elements of the y-axis:

ReportR bar chart - y-axis

  1. Y-Axis scale interval - use the arrows or enter a value to determine the spacing of the scale. In the example chart above, the scale interval is set at 20.
  2. Y-Axis max - use the arrows or enter the maximum value that should appear at the right-hand end of the scale.
  3. Y-Axis title - this is the label that will be shown immediately under the y-axis.
  4. Set number of decimal places - choose here whether you want to show data values with any decimal places or none (just set to 0). Keep it simple - more than 2 decimal places may overload the chart with too much data.
  5. Y-Axis gap width - this is the spacing or gap in between the columns. This will adjust the gap width in percentage, and also increase or decrease the bar width.
  6. Chart type - choose how you want your bar chart to be displayed

Tip: To make advanced design changes to the bar chart, use custom CSS.

1.3 Widget placement & Size

Choose how you would like to align your bar chart widget. You can choose to align it to one side and have explanatory text or another widget on the other side or center it.

PDF Bar chart placement

  • Left - widget will be aligned to the left side of the page, in a column layout
  • Center - widget will be presented centered across the entire page from the left to the right (full width)
  • Right - widget will be aligned to the right side of the page, in a column layout

If you would like a widget to appear side-by-side the bar chart, make sure to set the widget aligned on one side of the page, and the bar chart on the other. For example, choose to align the text widget to the left, and align a bar chart to the right.

Use the arrows or enter a value for the chart height and width. If you choose to place the bar chart on either the left or the right side of the page, the chart will be automatically resized.

PDF Bar chart size


The max-width of one page is 810 px. To leave some room for spacing the recommended  Width value is around 600 px.

Click the Update preview button to see how the widget you've created looks like

update preview button

Take a look below at some different possibilities:

If you want a quick preview to check how everything will be displayed, make sure you have at least one response. Then, simply click Save and Test PDF at the top of the page. Now if you want to show a bar chart to all respondents, you're done! Check out section 3 to see all available widgets.

2 Widget logic rules

If you want to only show this widget under certain conditions, it's time to set the widget logic rules. If you want to show a general widget that is visualized every time a PDF report is generated, you can choose not to include a widget logic rule. Learn more about Widget Logic

add widget logic rules

Once you've saved your logic rules, don't forget to Save changes and you're ready to add more widgets!

3 Other available widgets

Why not check out our other widget guides and learn how to add other types of content to your PDF? 

Here is a full list of widgets like text, image, table, and more! 

Support is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.