Layout

When you plot a widget, the widget appears on the dashboard canvas within a page with default dimensions. The width and height of the page within the boundaries of the dashboard canvas define the Page Type.

You can view the Page Type under Page Size on the widget formatting pane.

The table below describes the available Page Type options and their dimensions.

Page Type	Width (Max.)	Height (Max.)	Remark
16:9	1280	700	This is default page type when you open a dashboard. The page height and width cannot be altered. You can change the widget layout only within these maximum limits.
4:3	960	720	The page height and width cannot be altered. You can change the widget layout only within these maximum limits.
Letter	816	1030	The page height and width cannot be altered. You can change the widget layout only within these maximum limits.
Custom	1284	700	Only this page type has changeable width and height. By default, these values are 1284 and 700, respectively. You can change the page layout only within specific maximum limits.

When you plot a widget, its layout defines its width and height. The widget layout is smaller (in size) than that of the Page Type on which it is plotted.

You can change the widget layout using the Layout option available under Chart formatting options.

Note:

Layout option is available in all widgets.

The table given below describes different fields present on Layout formatting.

Field	Description	Remark
Width	It allows you to change the width of the widget.	When you plot a widget, the widget is displayed in its default width. The default width is different for different Page Types.
Height	It allows you to change the height of the widget.	On plotting a widget, you can see its default height. The default height is different for different Page Types.
Left	It allows you to change the distance of the widget from the left margin of the page.	When you plot a widget, the widget appears at its default distance from the left margin of the dashboard. The sum of the dimensions in Layout Width and Left should be <= the Width of the Page Type.
Top	It allows you to change the distance of the widget from the top margin of the page.	When you plot a widget, the widget appears at a default distance from the top margin of the dashboard The sum of the dimensions in Layout Height and Top should be <= the Height of the Page Type.

To use Layout formatting options, first plot any chart using the measures from the dataset.

In the figure below, we plot a Column Chart on a 16:9 Page Type.

Now, when you click the widget, the Chart menu is enabled.

Under Layout, you can see the default width and height values of the widget. You can also see its default distance from the left and top margins.

The figure below shows the default layout of the Chart.

In the figure,

The default position of the widget is near the top-left corner of the canvas.
The default width and height are 380 and 320, respectively.
The default distance from the left and top margins are 1 and 1.01, respectively.

Now, change the layout size and position.

The Width and Height are 500 and 500, respectively.
The Left and Top positions are 30 and 50, respectively.

Notes:

For a widget plotted on 16:9 Type of dashboard page,

The sum of the Width and distance from the Left margin should not be more than 1280.
The sum of the Height and distance from Top margin should not be more than 700.
Refer to Table: Page Types and their Dimensions and Table: Description of fields present in Layout formatting.

The resultant widget is shown below.

Since the sums mentioned above are within limits, the widget resizes to the newly selected dimension.

However, if the sums exceed the defined limits, the corresponding field is highlighted (red).

If you hover over the field, an error message “Value exceeds maximum limit” is displayed.

In the above example,

The widget width is 1270.
The distance of the widget from the left margin is changed to 15.

However, the sum 1270 + 15 is 1285, which is greater than the width limit (of 1280) of 16:9 Type of dashboard page. Hence, the Left field is highlighted, and an error message is displayed.

Notes:

You can manually drag the corners and edges of the widget and change the aspect ratio as required. In this case too, the aspect ratio of the widget should not exceed the defined limits.
Saving the new layout saves the widget at the same location where it was created.
According to the Page Type selected, Reset to default changes the widget position and size to its default position and size on the dashboard canvas.