# Features, image cards

- **[Sections](/blocks/)**
- **[Features](/blocks/features/)**
- **Features, image cards**

Section heading with up to two buttons at its right, and two to six equal cards, each a picture on top with a small badge, a title, a line and a text link; three in a…

## Import

- **CLI**

  ```
  npx shadcn add https://ui.klarhimmel.com/r/features-image-cards.json
  ```
- **Import**

  ```
  import Block from '@/components/klarhimmel/blocks/features-image-cards';
  ```

Also called

- features/image-cards

- **About**: Section heading with up to two buttons at its right, and two to six equal cards, each a picture on top with a small badge, a title, a line and a text link; three in a row on a wide container, or one row that scrolls sideways.
- **Category**: What it does, as a grid, a list, tabs or alternating rows. New project? Set it up once: /get-started/installation.

## Notes

- **When to use it**: Two to six equal cards, each with a picture, a badge, a title, a line and a text link, under a heading with up to two buttons. Pick `features-grid` for icons and `features-stacked-cards` for a pinned intro.
- **Writing for it**: - Use the badge for one short word of category or status, and keep titles to a line or two.
- Turn on the scroll setting to run the cards as one row that scrolls sideways with snapping and no script, which suits more than three.
- Up to two header buttons sit at the right of the heading. The first is the primary one.
- **Watch out for**: The scroll row cuts the last card at the edge on purpose to show there is more, so a row of exactly two cards looks empty. Use the grid for small sets.

## Pairs well with

- **[Hero, centered](/blocks/hero/centered)**
- **[Testimonials, grid](/blocks/testimonials/grid)**
- **[Call to action, band](/blocks/cta/banner)**

## 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 FeaturesImageCards from '@/components/klarhimmel/blocks/features-image-cards';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <FeaturesImageCards props={{
          "eyebrow": "Name the section",
          "title": "Say what the reader finds in these cards",
          "description": "Say in one sentence what the cards below have in common and who they are for.",
          "headerActions": [
            {
              "label": "Name the main action",
              "href": "#primary"
            },
            {
              "label": "Name the other action",
              "href": "#secondary"
            }
          ],
          "items": [
            {
              "media": {
                "src": "/pictures/photo-house1.avif",
                "alt": "A red wooden house with white windows and a white door"
              },
              "badge": "Category",
              "title": "Name the first item",
              "description": "Say in one line what it gives the reader.",
              "link": {
                "label": "Read more",
                "href": "#first"
              }
            },
            {
              "media": {
                "src": "/pictures/photo-key2.avif",
                "alt": "A key in the lock of a green door"
              },
              "badge": "Category",
              "title": "Name the second item",
              "description": "Say in one line what it gives the reader.",
              "link": {
                "label": "Read more",
                "href": "#second"
              }
            }
          ]
        }} />
      </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 120 characters.
- **description**: Text, up to 300 characters.
- **headerActions**: List of up to 2. Optional; empty is not rendered.
- **scroll**: Optional; empty is not rendered.
- **actionsInline**: Optional; empty is not rendered.
- **items**: List of 2 to 6. Each item: media, badge (optional), title, description, link (optional).
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/features/grid)

[Next](/blocks/features/list)
