Layout configuration options
When you select the canvas of your dashboard, you can change many of the dashboard layout settings in the visual editor Configuration panel. There are some options, however, that you can only set in the source editor. For example, the source editor is the only place to add a submit button for inputs.
The dashboard definition's layout
section is where the positions and sizes of visualizations, in pixels, are listed as they exist on the dashboard. You must also list any inputs in the globalInputs
area of the layout
section. For more information on inputs, see
Use inputs to make dashboards dynamic.
Layout options
Some of the following options are available through the visual editor and others are available only using the options
level of the layout section of the dashboard definition.
Option | Type | Default | Description |
---|---|---|---|
backgroundColor | string | lightmode: #FFFFFF darkmode: #FF0000 Splunk Cloud Platform: #171D21
|
Specify the color of the layout background color using a hexadecimal code, such as #FF0000 .
|
display | auto-scale , actual-size , or fit-to-width
|
auto-scale
|
Specify the display behavior. If this property is set to actual-size , changing the size of your browser doesn't change the size of your dashboard or visualizations. If this property is set to auto-scale , your dashboard and visualizations automatically also change size.
|
submitButton | Boolean | n/a | You can specify the layout option submitButton . When set to true , a user must select a Submit button for the input selection to take effect. If set to false or not specified at all, the dashboard immediately refreshes when a user makes a selection.
|
submitOnDashboardLoad | Boolean | n/a | To load the dashboard using the default input values, add the option submitOnDashboardLoad , which will automatically run searches on the first dashboard load. After the initial load, the user must select the Submit button to refresh the dashboard's searches and visualizations. If you don't add ubmitButton then submitOnDashboardLoad doesn't work.
|
backgroundImage | object | n/a | A background image must be one of the following types: JPG, JPEG, PNG, SVG, or GIF. You can also use a web based image using the backgroundImage.src option.
|
backgroundImage.src | SRC | n/a | Specify the location of a background image using the option src. For example: "src": "https://www.myImageLocation.com/galleryX/image1.png" .
|
backgroundImage.w | number | n/a | Specify the image width in pixels for w . Don't specify this option if you set the sizeType option. If you do, it will overrule that setting.
|
backgroundImage.h | number | n/a | Specify the image height in pixels for h . Don't specify this option if you set the sizeType option. If you do, it will overrule that setting.
|
backgroundImage.x | number | (0,y) | Specify the position in pixels of the background image on the x-axis. Don't specify this option if you set the sizeType option. If you do, it will overrule that setting.
|
backgroundImage.y | number | (x,0) | Specify the position in pixels of the background image on the y-axis. Don't specify this option if you set the sizeType option. If you do, it will overrule that setting.
|
backgroundImage.sizeType | auto , contain , or cover
|
contain
|
auto scales the image while maintaining the image proportion. contain increases the size of the image as much as possible without cropping or stretching it. cover increases the size of the image without stretching it. You can crop the image vertically and horizontally to minimize empty space.
|
width | number | 1140 | Specify the canvas width in pixels. The width option only applies to the absolute layout and is unavailable for the grid layout.
|
height | number | 960 | Specify the canvas height in pixels. The height option only applies to the absolute layout and is unavailable for the grid layout.
|
Input configuration options |
This documentation applies to the following versions of Splunk® Enterprise: 9.1.0, 9.1.1, 9.1.2, 9.1.3, 9.1.4, 9.1.5, 9.1.6, 9.2.0, 9.2.1, 9.2.2, 9.2.3, 9.3.0, 9.3.1
Feedback submitted, thanks!