# Features, showcase

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

A centred stack in one column: heading, a sentence and up to two buttons, then one wide picture under them. For a product or plan shown whole, mid-page.

## Import

- **CLI**

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

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

Also called

- features/showcase

- **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**: Mid-page, one product, plan or feature shown whole: a centred heading, a sentence and a button over one wide picture. For several features side by side use `features-grid`, and to open the page use `hero-centered`.
- **Writing for it**: - Eyebrow: a few words or empty, 60 characters at most.
- Title: name what the picture shows, 120 characters at most and best in one or two lines.
- Description: one or two sentences, 300 at most. Primary is one clear action; fill secondary only when a second path really exists, else leave its label empty.
- **Watch out for**: The picture carries the section, so give it a real product screen or photo with its own alt text: the empty placeholder reads as unfinished on a real page. Keep the description short, because the text is centred and long centred lines are hard to read. Two showcases in a row look like a slideshow, so set another block between them. Use titleSize heading when the section opens on a quiet one-line heading with no lead; keep title for a section that carries a lead.

## Pairs well with

- **[Features, grid](/blocks/features/grid)**
- **[Testimonials, cover](/blocks/testimonials/cover)**
- **[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 FeaturesShowcase from '@/components/klarhimmel/blocks/features-showcase';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <FeaturesShowcase props={{
          "eyebrow": "",
          "title": "Name the product or plan this section shows",
          "description": "Say in one or two sentences what it lets the reader do and who it is for.",
          "primary": {
            "label": "Main action",
            "href": "#"
          },
          "secondary": {
            "label": "",
            "href": ""
          },
          "media": {
            "src": "/pictures/photo-tree1.avif",
            "alt": "An oak canopy seen from below"
          },
          "titleSize": "title"
        }} />
      </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.
- **primary**: See the type.
- **secondary**: See the type.
- **media**: See the type.
- **titleSize**: One of 'title', 'heading'. Optional; empty is not rendered.
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/features/list)

[Next](/blocks/features/alternating)
