A header is a reserved area along the top of your dashboard that you can use to give your dashboard a unique identity, apply corporate branding standards, and provide links to additional content. You can also use it 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.
The header can be one of two sizes, small or large. The size of the header depends on how it's configured and its contents. For example, if your header includes a subtitle placed in the same line as the title, the header size is small. If the subtitle is placed below the title, the header size is large. When a header includes a logo, the logo size determines the header size. Headers that include at least one selector are always large.
Your header can include a logo by referencing an image with a URL or by using an icon. The URL for a header's logo can point to a Scalable Vector Graphics (.svg) file. In that case, the image automatically scales to the header's size. If you use other image formats, the following dimensions are suggested. Images larger than the suggested sizes are scaled down, but images that are smaller than these sizes are not scaled up.
The following table shows the heights of these sizes and the recommended dimensions of logos to insert into these headers.
| Header size | Header height (px) | Logo dimension (px) |
|---|---|---|
Small | 44 | 24x24 |
Large | 63 | 48x48 |
Tip:
You can use rich text elements 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 can use a rich text element to clearly mark different sections in your dashboard.
The following are tips for using URLs:
- Use HTTPS for URL references. If an HTTPS connection is not possible, consider using a relative URL, which doesn't specify HTTPS or HTTP. For example, use //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 you can use in a dashboard.
- If the URL references a domain that differs from yours, it is recommended that the server hosting the requested resources is able to support CORS requests from your domain.