# Exit Reasons

Source: https://docs.astalty.com.au/guide/settings/users-settings/exit-reasons

> Build the list of reasons you can record when a team member leaves, and archive the ones you no longer use.

Exit Reasons are the list of reasons you can record against a team member when you deactivate them, so exits are captured consistently and can be reported on.

> **These are staff exit reasons, not Participant exit reasons**
>
> Participants have a separate, unrelated exit reason that you record when you archive a Participant - see [Archiving and Restoring Participants](https://docs.astalty.com.au/guide/participants/archiving-restoring-participants). Nothing on this page affects it.

## Overview

Manage exit reasons in [**Settings > Users > Exit Reasons**](https://app.astalty.com.au/settings/users/exit-reasons). Every organisation starts with five: **Resignation**, **Dismissed**, **Redundancy**, **Retirement** and **Other**. Rename them, archive the ones that don't fit how you work, and add your own.

You choose a reason when you deactivate someone, and can change it afterwards - see [Restricting, Deactivating and Reactivating Users](https://docs.astalty.com.au/guide/deactivating-and-reactivating-users).

![The Exit Reasons card on Settings > Users, listing Dismissed, Other, Redundancy, Resignation and Retirement by Name and Created, with the Create Exit Reason button highlighted](https://docs.astalty.com.au/assets/exit-reasons-settings-card-guide.png)

By default, only Admins can create, rename and archive exit reasons.

## Creating an Exit Reason

1. Go to [**Settings > Users > Exit Reasons**](https://app.astalty.com.au/settings/users/exit-reasons).
2. Select **Create Exit Reason**.
3. Enter a **Name** - up to 255 characters.
4. Click **Create**.

The new reason is available immediately, and is sorted into the list by name.

> **An archived reason still holds its name**
>
> Names must be unique across your organisation, archived ones included. Reusing one fails with:
>
> > An archived exit reason named "Retirement" already uses this name. Unarchive it, or rename it, to free the name up.

## Renaming an Exit Reason

The name is the only thing you can change.

1. Open the three-dot menu on the reason and click **Edit**.
2. Change the **Name**.
3. Click **Update**.

> **Renaming applies to exits already recorded**
>
> A reason is linked to each exit rather than copied onto it, so renaming one changes how every exit already recorded against it reads - on staff profiles and in the Staff Retention report. To keep past exits worded as they are, archive the old reason and create a new one instead.

## Archiving an Exit Reason

Exit reasons can't be deleted. Archive one to take it out of use. **Archive** and **Unarchive** sit inside a reason's **Edit** view, so only someone who can also rename reasons can reach them.

1. Open the three-dot menu on the reason and click **Edit**.
2. Click **Archive** at the bottom left.
3. Confirm.

![The Update Exit Reason drawer for Resignation with a Name field and the Archive button in the bottom left highlighted](https://docs.astalty.com.au/assets/exit-reasons-edit-archive.png)

The confirmation reads:

> Are you sure you want to archive this exit reason? It can no longer be chosen when a team member is deactivated, but stays on the exits already recorded against it.

An archived reason drops out of the **Exit Reason** dropdown when you deactivate someone, but keeps its name reserved and stays on the exits already recorded against it. Where a deactivated team member already has one, it remains selectable on their exit and shows as *Resignation (archived)*.

### Unarchiving an Exit Reason

1. On the **Exit Reasons** card, set the **Status** filter to **Archived**.
2. Open the three-dot menu on the reason and click **Edit**.
3. Click **Unarchive**.

Unarchiving takes effect straight away - there is no confirmation step.

### Finding Archived Reasons

The **Status** filter offers **Active** and **Archived**, and defaults to **Active**. The table columns are **Name** and **Created**, and archived reasons are labelled **Archived** beside the name.

## Where Exit Reasons Appear

- **Staff profiles** - a deactivated team member's profile shows read-only **Exit Reason** and **Exit Details**. Both are hidden while someone is active.
- **Staff Retention report** - under **Reports → Team**. Its **Exit Reasons** card counts exits by reason; exits recorded without one count as **Not recorded**.
- **Audit trail** - changes to a team member's exit are recorded against them.

Exit reasons and exit details are not included in the Users export or the public API. The **Employment End Date** you set when deactivating someone is in the Users export.

> **Staff Retention is enabled per account**
>
> The **Staff Retention** report is in beta and switched on per organisation. If you can't see it under **Reports → Team**, contact Astalty Support at <support@astalty.com.au> to have it enabled.

## Related Guides

- [Restricting, Deactivating and Reactivating Users](https://docs.astalty.com.au/guide/deactivating-and-reactivating-users) - recording a reason when someone leaves, and updating it afterwards.
- [Users Settings](https://docs.astalty.com.au/guide/settings/users-settings) - the rest of the settings on this page.
