# Careers, open roles

- **[Sections](/blocks/)**
- **[Careers](/blocks/careers/)**
- **Careers, open roles**

Open roles grouped by team: a heading per team, and under it one row per role with its title, location, type and a Remote word where it applies, and a link that names…

## Import

- **CLI**

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

  ```
  import Block from '@/components/klarhimmel/blocks/careers-roles';
  ```

Also called

- careers/roles

- **About**: Open roles grouped by team: a heading per team, and under it one row per role with its title, location, type and a Remote word where it applies, and a link that names its role. Each team is a labelled section.
- **Category**: Open roles by team, and one role in detail. New project? Set it up once: /get-started/installation.

## Notes

- **When to use it**: The open roles of a company, grouped by team, for a careers page where people scan for their own field. A single role in full belongs in `careers-detail`.
- **Writing for it**: - The block takes one to four teams with one to six roles each. A team name holds 30 characters and each role title 80.
- The summary line, such as a count of open roles, is text you keep right yourself. It does not count the rows for you.
- The link label repeats on every row and the role title follows it for screen readers, so keep the label to a verb like View.
- **Watch out for**: Remote is a boolean per role that shows the remote label beside the location. Set the label word for your language, or it stays in English.

## Pairs well with

- **[Team, grid](/blocks/team/grid)**
- **[Careers, role detail](/blocks/careers/detail)**
- **[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 CareersRoles from '@/components/klarhimmel/blocks/careers-roles';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <CareersRoles props={{
          "eyebrow": "Name a topic",
          "title": "Invite people to join the team",
          "description": "Say in one or two sentences what the team cares about and that roles are open n…",
          "summary": "0 open roles",
          "remoteLabel": "Remote",
          "viewLabel": "Role details",
          "groups": [
            {
              "team": "First team",
              "roles": [
                {
                  "title": "Name the first role",
                  "location": "Name a place",
                  "type": "Type of role",
                  "remote": true,
                  "href": "#senior-fullstack"
                }
              ]
            }
          ]
        }} />
      </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.
- **summary**: Text, up to 40 characters.
- **remoteLabel**: Text, up to 20 characters.
- **viewLabel**: Text, up to 30 characters.
- **groups**: List of 1 to 4. Each item: team, roles.
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/careers/detail)

[Next](/blocks/integrations/featured)
