Chart and Text panel dimensions and ordering


When creating charts and text panels, you can control how big they will be when shown in the activities section or in workspace homepage/dashboards. This is done by configuring their Preferred width and Preferred height properties.

Preferred width

The Preferred width specifies how wide the chart/text panel will be relative to the screen size. The values specified here range from 1 to 12. This implies that if you have 12 charts/text panels and each has a width of 1 then you will have all the charts/text panels on one row. 

A row can contain up to 12 charts or text panels if each of them has a preferred width of 1. If a chart's preferred width is 12 then that single chart will occupy an entire row.

When setting up the preferred width of your charts or text panels, the activity charts table will guide you on which charts will be on a single row by underlining the last chart in the row with either a blue or thick gray bar.

A blue bar indicates that the preferred widths of the charts in the row correctly add up to 12 whereas a thick grey bar indicates that the preferred widths of the charts do not correctly add up to 12 though they will be on a dedicated row.

The thick grey bar is caused by the dimensions of the next chart not allowing it to be displayed on the same row as the set of charts before it.

Figure 1

Preferred Height

The preferred height specifies the ration of the preferred width to the height of the chart or text panel. For example a preferred width of 1 and preferred height of 1 indicates that the chart or text panel should be a square whereas a preferred width of 12 and preferred height of 6 indicates that the chart or text panel should be a rectangle. A preferred width of 6 and preferred height of 12 indicates that the chart should be 2 times bigger than it's wide.

Activity view vs Workspace homepage

On the Activity view, the exact preferred width requested is used. For example, a chart with preferredWidth of 5 and preferredHeight of 7 will be rendered in a 5x7 block. However, in the workspace homepage/dashboard, all dimensions are rounded up to the nearest multiple of 3. Using the same example, our chart of 5x7 will instead be displayed as 6x9. This rounding is done to achieve more uniformity in the shapes of visualizations on the homepage/dashboard.

It is therefore recommended that when testing your visualizations, if they are intended to be displayed on the workspace homepage, either pick dimensions that are a multiple of 3 (6x6, 12x3, etc), or be sure to test the layout visually in both the Activity view and the workspace homepage.


As a recipe builder, you can specify the order in which charts should be presented in the activity view. Note that this order is not respected in the workspace homepage, because charts are pulled from various different Activities.

The order is specified by dragging the chart or text panel up and down the chart table in the recipe manager. There will be indicators to show you which charts will be placed in a single row. These indicators have been explained in the section about setting preferred widths above.

Going with the ordering specified in Figure 1 above, that charts would appear as shown below in the activity view.


Have more questions? Submit a request


Article is closed for comments.