A header is a reserved area along the top of your dashboard that can be used for giving your dashboard a unique identity, applying corporate branding standards, and providing links to additional content. It can also be used in interactive dashboards to host one or more selectors. A dashboard can only have one header, and it's designed to always occupy the entire width of a dashboard.
Tip:
Rich text elements can be used throughout a dashboard as substitutes for headers. They can be useful when you don't want an element that conforms to the header's size and position restrictions. For example, you could use a rich text element to clearly mark different sections in your dashboard.
The header can be one of three sizes. The following table shows the heights of these sizes and the recommended dimensions of logos to insert into these headers. The URL for a header's logo can point to a Scalable Vector Graphics (.svg) file. In that case, the image will automatically scale to the header's size. If you use other image formats, the following dimensions are suggested. Note that images larger than the suggested sizes will be scaled down, but images that are smaller than these sizes will not be scaled up.
| Header size | Header height (px) | Logo dimension (px) |
|---|---|---|
Small | 32 | 24x24 |
Medium | 44 | 32x32 |
Large | 62 | 48x48 |
The following are tips for using URLs:
- If your dashboard will only be accessed over a secure HTTPS connection, use HTTPS: in your URL references. If not, consider using a relative URL, which doesn't have the HTTPS: or HTTP: scheme specified, such as: //www.example.com/logo.png.
- If you don't want to use the above tip, consider leveraging your organization's ability to add image files as items in your organization's content. After adding the new item, share it with everyone. This will produce a URL on the image's item details page that can be used in a dashboard.
- If the URL references a domain that differs from yours, the server hosting the requested resources should support CORS requests from your domain.