# Schedule, header row list

- **[Sections](/blocks/)**
- **[Schedule](/blocks/schedule/)**
- **Schedule, header row list**

A heading with its label on the left and one or two actions on the right of the same row, a wide picture with a caption across the full width below, then dated entries…

## Import

- **CLI**

  ```
  npx shadcn add @klarhimmel/schedule-header-row-list
  ```
- **Import**

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

Also called

- schedule/header-row-list

- **About**: A heading with its label on the left and one or two actions on the right of the same row, a wide picture with a caption across the full width below, then dated entries as cards in a grid, each with a date, time, name, line and tag.
- **Category**: What happens when: sessions, classes or events set out as a list or along a line. New project? Set it up once: /get-started/installation.

## Notes

- **When to use it**: Pick it for a program of dated entries that wants a strong opening: the heading and its actions share one row, a wide picture follows, then the entries as cards in a grid. For a narrow column with the picture first and thin dividing lines instead of cards, pick `schedule-picture-top-list`; for a plain feature grid with no dates, pick `features-grid`.
- **Writing for it**: - Title up to 80 characters, caption up to 120, at most 9 entries.
- Each entry holds a date, a time, a name up to 60, one line up to 160 and an optional tag and badge.
- Keep dates and times in one format across all entries.
- **Watch out for**: Cards in the last grid row look ragged when the count is not a multiple of three, so use three, six or nine entries. Leave the badge empty on most cards so the one that has it stands out.

## Pairs well with

- **[FAQ, list](/blocks/faq/accordion)**
- **[Call to action, band](/blocks/cta/banner)**
- **[Contact, channels](/blocks/contact/channels)**

## 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 ScheduleHeaderRowList from '@/components/klarhimmel/blocks/schedule-header-row-list';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <ScheduleHeaderRowList props={{
          "eyebrow": "Section name",
          "title": "Say what the schedule is for",
          "primary": {
            "label": "Main action",
            "href": "#start"
          },
          "secondary": {
            "label": "Second action",
            "href": "#contact"
          },
          "media": {
            "src": "/pictures/photo-food1.avif",
            "alt": "Caramelised figs on a white plate"
          },
          "caption": "Say what the picture shows in a few words.",
          "items": [
            {
              "date": "Weekday and date",
              "badge": "Label",
              "time": "Start and end time",
              "title": "Name the first entry",
              "description": "Say in one line what the visitor gets.",
              "tag": "Tag"
            },
            {
              "date": "Weekday and date",
              "badge": "",
              "time": "Start and end time",
              "title": "Name the second entry",
              "description": "Say in one line what the visitor gets.",
              "tag": "Tag"
            },
            {
              "date": "Weekday and date",
              "badge": "",
              "time": "Start and end time",
              "title": "Name the third entry",
              "description": "Say in one line what the visitor gets.",
              "tag": "Tag"
            }
          ]
        }} />
      </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 60 characters.
- **title**: Text, up to 80 characters.
- **primary**: See the type.
- **secondary**: Optional; empty is not rendered.
- **media**: See the type.
- **caption**: Text, up to 120 characters.
- **items**: List of 1 to 9. Each item: date, badge, time, title, description, tag.
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/products/tile-mosaic)

[Next](/blocks/schedule/picture-top-list)
