ReportR: Bar Chart
Add a Bar Chart widget to your customized report to show respondent's results or another data set at a glance.
This guide will discuss:
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.
1.1 Basic bar chart settings
Then it's time to get into the details of the chart:
- Dimension name - this is the legend that will be displayed underneath the bar chart describing what each bar is showing.
- Metric name - the name that will be displayed on the left-hand side of the chart, labelling the bar. This name should describe what the category the bar is displaying, for example different topics or areas of skills.
- 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.
- 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.
- 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.
1.2 Y-Axis settings
Once you've set up the bars, you can adjust a number of elements of the y-axis:
- 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.
- Y-Axis max - use the arrows or enter the maximum value that should appear at the right-hand end of the scale.
- Y-Axis title - this is the label that will be shown immediately under the y-axis.
- 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.
- 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.
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.
- 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.
Take a look below at some different possibilities:
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.
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. Click add rule and now select which condition from the drop-down menu should be used to decide when to show the widget.
Once you've chosen the initial condition, you can specify exactly what conditions need to be met, for example the answer on question must be greater than a certain number. If you need additional conditions (and probably more complex ones as well), click on the white circle with a purple + sign to add criteria that will be in addition to the other criteria (AND), or instead of (OR).
Tip: If you have set up outcomes, you can choose an outcome as the criteria for showing the widget. Choose outcome from the drop-down menu and then select what the outcome should or should not equal so that the widget will be shown. You can set the outcome as the only criteria, or as an additional criteria as shown below. In this example, we clicked the purple + button and added that the widget should be shown if both the response on intro field criteria AND the outcome criteria is fulfilled.
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?