> For the complete documentation index, see [llms.txt](https://docs.notionapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.notionapps.com/use-cases/employee-directory.md).

# Employee Directory

## Build this

Browse people as image cards (**Grid**) and open profile **Details**. Usually private for an internal org.

## Notion setup

* **People / Employees** — Name, Photo, Team, Title, Email
* Consistent image aspect ratio for Grid cards
* Private app if the directory is internal-only

## Screens to add

1. **Grid** of employees
2. **Details** profile
3. Optional filters by Team
4. Optional User field components for managers

## Build path (15–30 minutes)

1. [Grid view](https://docs.notionapps.com/screens-and-components/grid-view)
2. [Types of Screens](https://docs.notionapps.com/screens-and-components/types-of-screens)
3. [View Types](https://docs.notionapps.com/screens-and-components/customize-a-screen/view-types-list-grid-calendar-board)
4. [User field](https://docs.notionapps.com/screens-and-components/type-of-components/user-field)
5. [Auth and access](https://docs.notionapps.com/users/auth-and-access) if private

## Common pitfalls

* Mixed image sizes making the Grid look broken
* Publishing publicly when HR data must stay private
* Too many properties on the Grid card

## Verify

1. Open Grid on phone and desktop widths.
2. Open a profile Details page.
3. If private, confirm guests are blocked.

## Related

* [Catalogue](https://docs.notionapps.com/use-cases/catalogue)
* [Use Cases overview](https://docs.notionapps.com/use-cases/use-cases-overview)