> For the complete documentation index, see [llms.txt](https://docs.carpose.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.carpose.de/misc-modules/07_employee-selection.md).

# Employee Selection

{% hint style="info" %}
The Employee Selection component displays a fixed, hand-picked set of employees in the order you list them.
{% endhint %}

## Introduction

The `employee-selection` component renders a specific selection of employees — chosen by UUID — in a simple two-column card grid. Unlike the [Employee List](/misc-modules/05_employee-list.md), it has no tabs, headlines, filters, or team grouping: it shows exactly the employees you list, in the order given. This is useful for "your contacts" sections or curated team strips.

## Basic Usage

```html
<div
  data-carpose-component="employee-selection"
  data-api-key="your-api-key"
  data-ids="550e8400-e29b-41d4-a716-446655440000,7c9e6679-7425-40de-944b-e07fc1f90ae7"
></div>
```

## Attributes

| Attribute                | Required | Description                                                                        |
| ------------------------ | -------- | ---------------------------------------------------------------------------------- |
| `data-carpose-component` | Yes      | Must be `employee-selection`                                                       |
| `data-api-key`           | Yes      | Your Carposé API key                                                               |
| `data-ids`               | Yes      | Comma-separated list of employee UUIDs to display, in the order they should appear |

## Behavior

* Fetches and displays only the listed employees, in the given order
* Renders a two-column card grid with no tabs, headlines, filters, or grouping
* UUIDs that do not match an employee are skipped

## Notes

* For a full, team-grouped list of employees, use [Employee List](/misc-modules/05_employee-list.md)
* For a single employee profile, use [Employee Single](/misc-modules/06_employee-single.md)