--- title: "Directory" description: "Directory is the people side of Pyn: every employee the workspace knows about, the groups they belong to, and the demographics those groups are built from." sidebar: label: Overview order: 0 area: directory appPath: /directory/home audience: admin related: - directory/tutorial-first-upload-and-groups - directory/employees - directory/employee-groups - directory/demographics - integrations intercom: - id: "16755797" title: How to Upload Employee Data Manually (Pyn 2) url: https://intercom.help/pyn/en/articles/16755797-how-to-upload-employee-data-manually-pyn-2 - id: "12651638" title: Understand Groups in Pyn (Pyn 2) url: https://intercom.help/pyn/en/articles/12651638-understand-groups-in-pyn-pyn-2 --- Every message Pyn sends goes to an employee, on a date taken from their record, in their time zone, often because of the group they are in. Directory is where those records live. Employees arrive from your HRIS, from a spreadsheet you upload, or from the people your Slack, Google or Microsoft integration can see; Pyn merges each person's sources into one profile with a lifecycle stage, a manager, a buddy and the demographics that place them in groups. Directory is for admins and owners. Other roles do not see it in the navigation, although flows read employee data on their behalf. ![Directory > Employees lists everyone in the workspace with their country and time zone.](https://support.pynhq.com/media/directory/employees/directory-employees-list.png) ## Concepts - **Employee**: one person, assembled from one or more **sources** (a HiBob record, an Employee File row, a Slack member). The profile shows the merged result; the **Sources** tab shows the parts. - **Lifecycle stage**: **Upcoming Joiner**, **Current Active Employee**, **Extended Leave** or **Terminated**, worked out from start date, termination date and active status. The **Active**, **Upcoming** and **Inactive** views split the list by stage. - **Relations**: **Manager**, **Buddy**, **Mentor** and **HRBP**, each another employee. Flows send to them as recipients, and groups can be built from who has or lacks one. - **Demographic**: a property such as Department or Location that Pyn turns into one group per value. Five are set up for you; you add more from the properties your sources supply. - **Group**: a saved set of employees used as an audience: **Demographic**, **Lifecycle**, **Filter**, **Relationship** or **Static**. ## Views | Group | Views | What they list | | --- | --- | --- | | **Employees** | **Active**, **Upcoming**, **Inactive** | Employees by stage, as a table or a gallery. | | **Employee Groups** | **All Groups**, **Demographic**, **Lifecycle**, **Filter** | Every group, or one kind. | | **Customize** | **All Demographics** | The demographics that produce groups. | ## What you can do here - Find people: [Find an employee](https://support.pynhq.com/directory/employees/find-an-employee/), [Read an employee profile](https://support.pynhq.com/directory/employees/read-an-employee-profile/), [Export employees](https://support.pynhq.com/directory/employees/export-employees/). - Keep the data right: [Upload employees from a spreadsheet](https://support.pynhq.com/directory/employees/upload-employees-from-a-spreadsheet/), [Add an upcoming employee](https://support.pynhq.com/directory/employees/add-an-upcoming-employee/), [Fix a missing manager, time zone or email](https://support.pynhq.com/directory/employees/fix-missing-details/). - Build audiences: [Create a filter group](https://support.pynhq.com/directory/employee-groups/create-a-filter-group/), [Create a static group](https://support.pynhq.com/directory/employee-groups/create-a-static-group/), [Create a relationship group](https://support.pynhq.com/directory/employee-groups/create-a-relationship-group/), [Create a demographic](https://support.pynhq.com/directory/demographics/create-a-demographic/). - [Tutorial: your first employee upload and groups](https://support.pynhq.com/directory/tutorial-first-upload-and-groups/): From a spreadsheet to a filter group an automation can target. About 25 minutes. - [Reference: employee properties](https://support.pynhq.com/directory/employees/reference-employee-properties/): Every field on a profile, where it comes from, and how stage and time zone are worked out. - [Reference: group types](https://support.pynhq.com/directory/employee-groups/reference-group-types/): Demographic, Lifecycle, Filter, Relationship and Static groups, and the ones every workspace starts with. ## Where it is in the app Open **Directory** in the primary navigation on the left of every page, or open `/directory/home`. It lands on **Employees** > **Active**; the other views are listed on the left. An employee or group opens in a panel on the right. **Search** at the top of the navigation finds employees and groups from anywhere in Pyn. ## Related - [Your first employee upload and groups](https://support.pynhq.com/directory/tutorial-first-upload-and-groups/) to go from an empty workspace to a usable audience. - [Employees](https://support.pynhq.com/directory/employees/) for the list and the profile. - [Employee Groups](https://support.pynhq.com/directory/employee-groups/) for audiences. - [Demographics](https://support.pynhq.com/directory/demographics/) for the properties behind demographic groups. - [Integrations](https://support.pynhq.com/integrations/) for the HRIS and Employee File sources that feed Directory. ## Related Intercom articles - [How to Upload Employee Data Manually (Pyn 2)](https://intercom.help/pyn/en/articles/16755797-how-to-upload-employee-data-manually-pyn-2) - [Understand Groups in Pyn (Pyn 2)](https://intercom.help/pyn/en/articles/12651638-understand-groups-in-pyn-pyn-2)