Docs
← Back to site

Docs Home LookNew

3 min readUpdated November 21, 2026

The Look section of Settings → Display → Docs home sets the spacing of the page and the hero at the top: the area with the heading and the search box. It applies to the Search hub and Grouped by role layouts. Colors and fonts still come from Appearance.

A live preview at the top of the section shows the hero as you change it. The preview is in light mode, and your site’s fonts may look a little different.

The Look section with an image background, the overlay settings and the live preview

Spacing#

The space between the sections under the hero: Compact, Normal or Roomy. Normal is a little tighter than before 1.0.17.

Hero size and alignment#

  • Hero size. Compact, Normal or Tall. Tall suits a background image.
  • Hero alignment. Centered or Left.
A tall hero aligned left, with the overlay darker behind the text

Hero background#

Choice What it does
Plain Uses your card color from Appearance. The default.
Accent tint A light wash of your accent color.
Color A color you pick, with its own color for dark mode. Leave dark mode empty and a darker version of your color is used.
Image A background image, with an overlay to keep the text readable.

Background image#

When you choose Image:

  • Image. Choose it from the Media Library. Use a wide photo or pattern, at least 1920 pixels across. Text sits on top, so a calm image works best.
  • Dark mode (optional). A second image for dark mode. Leave it empty to use the same image.
  • Keep in view. Which part of the image stays visible when the hero is cropped on small screens: the middle, the top or the bottom.
  • Background color. Shows while the image loads.
The Search hub hero with a background image in light mode
The same hero in dark mode

Overlay#

A layer of color over the image, so the heading and search stay easy to read.

  • Overlay color. Dark navy by default.
  • Strength. From 0% to 90%. The default is 55%.
  • Style. Even covers the whole image. Darker at the bottom fades in toward the bottom. Darker behind the text is darkest on the text side, and works best with the Left alignment.

Hero text#

Automatic uses light text on a dark color or overlay, and dark text on a light one. Choose Light or Dark to set it yourself.

On phones#

The hero and the spacing shrink on small screens, and Keep in view decides which part of the image stays visible.

The hero with a background image on a phone

Checks#

The checks at the bottom of the tab warn you when Image is chosen but no image is set (or it was deleted), and when Color is chosen without a color. With an overlay under 25%, they remind you to check that the heading is easy to read on your image.

Going further with CSS#

The hero’s look is set with CSS variables, so you can fine-tune it in Settings → Team & advanced → Custom Code. Your own CSS there wins over the Look settings. See Theming with CSS Variables for the list.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only