# Hero, header row

- **[Sections](/blocks/)**
- **[Hero](/blocks/hero/)**
- **Hero, header row**

A heading and a short lead on the left with the actions on the same row at the right, and a wide picture below, with an optional caption.

## Import

- **CLI**

  ```
  npx shadcn add https://ui.klarhimmel.com/r/hero-header-row.json
  ```
- **Import**

  ```
  import Block from '@/components/klarhimmel/blocks/hero-header-row';
  ```

Also called

- hero/header-row

- **About**: A heading and a short lead on the left with the actions on the same row at the right, and a wide picture below, with an optional caption. On a phone the actions stack under the lead, full width, and the picture follows.
- **Category**: The first screen: what it is, who it is for, what to do next. New project? Set it up once: /get-started/installation.

## Notes

- **When to use it**: A heading and short lead at the left with the actions on the same row at the right, then one wide picture and an optional caption. Pick `hero-media-foot` when the picture should come first.
- **Writing for it**: - Choose the title size for the page: title for a modest heading and display for a large page opening.
- Use the shape of the picture to set the pace. Wide is 21 by 9 and cinema is 16 by 7, so a cinema crop wants a subject along the middle.
- Add the caption only when it tells the reader something the picture does not, such as a place or a date.
- **Watch out for**: On a phone the actions stack under the lead at full width and the picture follows at 4 by 3, so the crop changes. Check that the subject survives both shapes.

## Pairs well with

- **[Logos strip](/blocks/logo-cloud/row)**
- **[Features, image cards](/blocks/features/image-cards)**
- **[Call to action, minimal](/blocks/cta/minimal)**

## Usage

The block in a page, with its default content (long lists shortened). Every prop is in the table below.

section.tsx

```
import { Theme } from '@/components/klarhimmel/theme/style';
import { BlockSurface } from '@/components/klarhimmel/blocks/surface';
import HeroHeaderRow from '@/components/klarhimmel/blocks/hero-header-row';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <HeroHeaderRow props={{
          "eyebrow": "Name the topic in two words",
          "title": "Say in one line what this page is about",
          "headingSize": "title",
          "description": "Write one or two short lines on what the reader gets here and who it is for.",
          "primary": {
            "label": "Main action",
            "href": "#start"
          },
          "secondary": {
            "label": "Second action",
            "href": "#more"
          },
          "media": {
            "src": "/pictures/photo-tree1.avif",
            "alt": "An oak canopy seen from below"
          },
          "caption": "",
          "pictureShape": "wide"
        }} />
      </BlockSurface>
    </Theme>
  );
}
```

## Props

The type, default and text limit of every prop. On a real page, over-limit text is kept and checkSections flags it (Installation, Check a page before you ship); this live preview shows the default until it fits. The panel above edits all props.

- **eyebrow**: Text, up to 40 characters.
- **title**: Text, up to 100 characters.
- **headingSize**: One of 'title', 'display'. Optional; empty is not rendered.
- **description**: Text, up to 200 characters.
- **primary**: See the type.
- **secondary**: Optional; empty is not rendered.
- **media**: See the type.
- **caption**: Text, up to 120 characters.
- **pictureShape**: One of 'wide', 'cinema'. Optional; empty is not rendered.
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/hero/frame)

[Next](/blocks/hero/media-foot)
