# Hero, facts

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

A hero with no picture: one large sentence, a thin rule, then two to four facts stacked under it, each a small label, a large value and an optional link (the next date…

## Import

- **CLI**

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

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

Also called

- hero/facts

- **About**: A hero with no picture: one large sentence, a thin rule, then two to four facts stacked under it, each a small label, a large value and an optional link (the next date and tickets, where, opening hours, a price from).
- **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**: An opener with one large sentence and two to four facts stacked under a thin rule, for an event, a venue or a trade whose visitors want the date, the place and the hours first. Use `hero-centered` when the page opens on a promise instead.
- **Writing for it**: - Write each fact as a small label over a large value, such as Next date over a day and month, so the stack scans like a timetable.
- Link a fact only when its page adds something, like the event or a map. The label and value then act as one link.
- Use the further step under a fact for one action, such as booking or directions, and leave its label empty when there is none.
- **Watch out for**: The stack holds only two to four facts, and a fifth would need a different block. Write values that fit on one line at display size, since a long value wraps and breaks the rhythm.

## Pairs well with

- **[Features, grid](/blocks/features/grid)**
- **[FAQ, list](/blocks/faq/accordion)**
- **[Contact, address and map](/blocks/contact/map)**

## 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 HeroFacts from '@/components/klarhimmel/blocks/hero-facts';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <HeroFacts props={{
          "title": "Say in one sentence what you are and who you are for, in the words a visitor would use",
          "facts": [
            {
              "label": "Name the first fact",
              "value": "The first fact, as a date or place",
              "href": "#first",
              "link": {
                "label": "The next step",
                "href": "#next"
              }
            },
            {
              "label": "Name the second fact",
              "value": "The second fact, in a few words",
              "href": "#second",
              "link": {
                "label": "",
                "href": ""
              }
            }
          ]
        }} />
      </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.

- **title**: Text, up to 160 characters.
- **facts**: List of 1 to 4. Each item: label, value, href (optional), link (optional).
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/hero/cover)

[Next](/blocks/hero/figure)
