Docs Home LookNew
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.

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.

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.


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.

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?
Thanks for your feedback!
✓ Feedback received. Thank you!