---
schema_version: "1"
id: 392bef39b4912664d46498ebd081f2ac578d697ffefaa10388406da6c9eddff7
title: style Properties
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/bi_dev_guide_json/guides/bi-dbjson-gridlayout-widgets-style-properties.md
canonical_url: https://developer.salesforce.com/docs/analytics/bi-dev-guide-json/guide/bi-dbjson-gridlayout-widgets-style-properties.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 5bc269468ad1ac2f381c6c12d8c84b4a0ce3ed50686c104c41a363541987c7de
products:
  - Analytics Dashboard JSON Developer Guide
  - analytics
---

# style Properties

The `style` key contains the dashboard properties, like cell spacing in the grid, as well as the dashboard's background color or image.

<sfdocstbl><table><col /><col /><col /><thead><tr><th>Property Name</th><th>Type</th><th>Details</th></tr></thead><tbody><tr><td><code>alignmentX</code></td><td>String</td><td><p>The horizontal alignment of the background image applied to the dashboard.</p> <p>Valid values are: <code>left</code> (default), <code>center</code>, and <code>right</code>.</p> <p>Included in the Dashboard Designer's user interface.</p></td></tr><tr><td><code>alignmentY</code></td><td>String</td><td><p>The vertical alignment of the background image applied to the dashboard.</p> <p>Valid values are: <code>top</code> (default), <code>center</code>, and <code>bottom</code>.</p> <p>Included in the Dashboard Designer's user interface.</p></td></tr><tr><td><code>backgroundColor</code></td><td>String</td><td><p>Background color of the dashboard, specified in hex color code. The default is <code>#FFFFFF</code>. Included in the Dashboard Designer's user interface.</p></td></tr><tr><td><code>cellSpacingX</code></td><td>Integer</td><td><p>Horizontal spacing (in pixels) between cells in the dashboard grid.</p> <p>Valid values are <code>0</code>, <code>4</code>, <code>8</code> (default), and <code>16</code>.</p> <p>Included in the Dashboard Designer's user interface.</p></td></tr><tr><td><code>cellSpacingY</code></td><td>Integer</td><td><p>Vertical spacing (in pixels) between cells in the dashboard grid.</p> <p>Valid values are <code>0</code>, <code>4</code>, <code>8</code> (default), and <code>16</code>.</p> <p>Included in the Dashboard Designer's user interface.</p></td></tr><tr><td><code>documentId</code></td><td>String</td><td>The 15-character document ID of the image to apply as the dashboard's background. To ensure security, upload the image file to Salesforce as a document, and select the <strong>Externally Available Image</strong> option. If this option is not selected or the referenced document is not an image, the image doesn't show up. Included in the Dashboard Designer's user interface.</td></tr><tr><td><code>fit</code></td><td>String</td><td>Indicates how to scale the image.<p>Valid values are: <code>original</code> (default), <code>stretch</code>, <code>tile</code>, <code>fitwidth</code>, and <code>fitheight</code>.</p><p>Included in the Dashboard Designer's user interface.</p></td></tr><tr><td><code>image</code></td><td>Array</td><td><p>Identifies the image using the following properties.</p> <ul><li><p><strong>name</strong>: Name of the image.</p></li><li><p><strong>namespace</strong>: Optional. Namespace of the image. Default is null.</p></li></ul> <p>Included in the Dashboard Designer's user interface.</p></td></tr></tbody></table></sfdocstbl>

## image Example

```nolang
"image": {
    "name": "My_Corporate_Logo",
    "namespace": ""
}
```