> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Item types

> What opens each kind of Inbox item, who gets it, how to work it, and what closes it.

Two kinds of item open now: **Reply needed**, which Alex adds itself, and the items your workflows' **Send to Inbox** steps add. Every other item comes from a **Send to Inbox** step. The four older kinds (**Asked for a person**, **Alex couldn't answer**, **Needs decision** and **Asked for an accommodation**) no longer open on their own, and are covered [at the end](#older-kinds-that-no-longer-open). For each kind, this page covers what opens it, who sees it, how to work it, and what closes it.

## Reply needed

**Opens when** a candidate sends a text, WhatsApp message or email while Alex is paused for them. While Alex is paused, Alex holds the message instead of answering it.

**Shows in Assigned to me for** whoever sent the candidate the last message before theirs (it's assigned to them, if they can work the item; when Alex sent it, nobody), and in My jobs for everyone who owns or follows the job.

> [!TIP]
>
> You pause Alex from the candidate's Activity thread with **Pause Alex**. Pausing means "we're handling this candidate ourselves", so every message they send while paused lands in the Inbox instead of getting an answer from Alex.

### How to work it

You see the full conversation with the candidate, with the **Reply needed** note above the message box. It says Alex is paused for this candidate, so Alex isn't replying.

* **To answer yourself**, write your reply in the message box and send it by text, WhatsApp or email. Sending closes the item as **Replied**.
* **To hand the conversation back to Alex**, resume Alex. You can do that from the conversation, or with **Mark complete** (see [Mark complete on a reply](https://docs.alex.com/inbox/using-your-inbox.md#mark-complete-on-a-reply)). Resuming closes the item as **Alex resumed**.

![A Reply needed item: the conversation, with the Reply needed note above the message box](https://mintcdn.com/apriora/MDTG4MwWsGXMaoCb/images/inbox/inbox-reply-needed.png?fit=max\&auto=format\&n=MDTG4MwWsGXMaoCb\&q=85\&s=06c6f32c32124c0786005d0ecebe200d)

### What closes it

| Closes when | Shown as |
| - | - |
| Someone sends the candidate a message (email, text or WhatsApp) | Replied |
| Alex is resumed for the candidate, anywhere in Alex | Alex resumed |
| Someone marks it complete and keeps Alex paused | Marked complete |

## Your workflows' item types (Send to Inbox)

**Opens when** a candidate reaches a **Send to Inbox** step in a job's workflow, or in a candidate workflow. Each step picks one of your company's **item types**, such as "Reference check" or "Salary over range". Admins set the types up under **Item types** on the **Company** tab of **Settings → Inbox** (see [Set up the Inbox](https://docs.alex.com/inbox/set-up.md#item-types)), and anyone who edits workflows can add one from the step itself.

A type has three things:

* a **name**, which is what the list shows for every item of that type, and what people filter and hide by,
* a **note**, with what to look at or do, such as "Ask whether the shift premium closes the gap." It can use variables, such as the candidate's first name, which are filled in for each candidate, and
* a **right panel**: the candidate's **Conversation**, or their interview **Report**.

When an item opens, it keeps the type's note and right panel as they were then. Editing a type later changes only the items that open afterwards, but a new name shows on every item of the type right away.

A candidate has one item per Send to Inbox step on a job. In a candidate workflow the item has no application, so a candidate has one per step. If they reach the same step again while the item is open, the item moves back to the top with the type's latest note.

**Shows in My jobs for** everyone who owns or follows the job. An item from a candidate workflow has no job, so it shows in nobody's My jobs: only people with **Inbox: View all items** see it, under **All** in the Jobs menu, and anyone it's assigned to sees it in **Assigned to me**.

### How to work it

The note above the panel says **From your workflow** and the type's name, for example **From your workflow · Reference check**, with the type's note below it. Beside it you see either:

* **the conversation**, so you can reply to the candidate by text, WhatsApp or email, or
* **the interview report**, for a type whose right panel is Report.

Do what the note asks, then **Mark complete**. Replying to the candidate doesn't close this item unless the step's **Resolve when** says so (see below), because the step may ask for something other than a reply.

### Set up a Send to Inbox step

1. Open the job's workflow, or your candidate workflow, and add **Send to Inbox** from **Actions**, at the point where a person should take over. For example, after an **Is** check that a candidate's expected salary is above the range.
2. Pick its **Type**. To add one, choose **Create type…** at the bottom of the list, fill in the name, note and right panel, and choose **Create and use**.
3. Optionally, choose **Resolve when** (below).
4. Save the workflow.

A type whose right panel is **Report** can only be used by a step that comes after **Interview Completed** or a decision, because the report doesn't exist before the interview ends. The picker shows such a type greyed out on any other step, and the workflow won't save with one there.

> [!NOTE]
>
> Steps added before item types keep working as they were: their items show as **Follow up**, with the step's own title as the line and its own note and right panel. The step shows a reminder to pick a type, but the workflow still saves and publishes without one. Once you pick a type, the step uses the type's name, note and right panel instead.

### Resolve when

**Resolve when** says what should close the item without anyone marking it complete. Tick as many as you like. The item closes as soon as any one of them happens. Leave them all unticked and nothing closes the item on its own.

| Option | What it does |
| - | - |
| **Someone on the team messages the candidate** | Closes when a teammate sends the candidate a message, from Alex (email, SMS or WhatsApp). |
| **A decision is made** | Closes when anyone records a decision on the candidate's application. To close only for some decisions, pick which ones. |
| **The candidate moves to another round** | Closes when the candidate's application leaves the round it was in when the item opened. |
| **Nobody acts on it within…** | Closes after the number of days you set (1 to 90), when nothing else has closed it. |

A step in a candidate workflow offers only **Someone on the team messages the candidate** and **Nobody acts on it within…**: its item has no application, so no decision or round change can close it.

Whatever you choose:

* **Someone can always mark the item complete.**
* **The item resolves when the application is withdrawn or deleted.**

If the candidate reaches the step again while the item is open, the item keeps the options it opened with.

### Removing a type

An admin removes a type under **Item types** on the **Company** tab of **Settings → Inbox**. If any workflow step uses it, they pick another type to replace it, and every one of those steps changes to that type from then on, in published workflows and in drafts with unpublished changes. Candidates who were already partway through a workflow get the replacement when they reach the step. A draft nobody has changed yet keeps the old type: when someone next opens it, the step asks for a type.

The removed type's items, open and done, leave everyone's Inbox: the list, the counts, the badge, the Type filter and **My Preferences** in Settings → Inbox. They aren't deleted, and what people did with them stays in each candidate's Activity. If the step runs again for a candidate, they get a new item with the replacement type.

> [!NOTE]
>
> The rest of the workflow runs whatever the step does. It doesn't add a candidate whose application was already withdrawn or deleted, unless the step runs because the candidate withdrew.

### What closes it

| Closes when | Shown as |
| - | - |
| Something you ticked under **Resolve when** happens | Replied, Decided or Decided elsewhere, Moved to another round, or Closed: nobody acted on it in time |
| The candidate withdraws, or their application is deleted | Withdrawn |
| Someone marks it complete | Marked complete |

A rejection doesn't close it unless you ticked **A decision is made**: the step may still need someone, for example to let the candidate know why.

## Older kinds that no longer open

Alex no longer adds an item on its own when a candidate asks for a person, asks for an accommodation, asks a question Alex couldn't answer, or finishes the last interview round. The workflow decides what your team sees: add a **Send to Inbox** step where it happens, or an email step to tell someone. Items of these kinds that opened earlier still show, open or done, and you work them as before:

* **Asked for a person** (**Wants a person** in the list): get in touch by text, WhatsApp, email or another way. Sending the candidate a message closes it as **Replied**; otherwise **Mark complete**.
* **Asked for an accommodation** (**Accommodation** in the list): the note shows what the candidate asked for. Sending the candidate a message closes it as **Replied**; otherwise **Mark complete**.
* **Alex couldn't answer** (**Question** in the list): answer the candidate, add the answer to the job's interview guide, or **Mark complete**. Sending the candidate a message closes it as **Replied**.
* **Needs decision** (**Decide** in the list): read the report and choose **Reject** or **Shortlist** in the decision bar, which needs **Decisions: Can set**. The decision closes the item as **Decided**, or **Decided elsewhere** when it syncs in from your ATS. Marking it complete closes it without a decision.

All four also close as **Withdrawn** when the candidate withdraws or their application is deleted, and **Mark complete** closes them as **Marked complete**. A **Needs decision** item that opened with a time limit still closes when it runs out, as **Closed: nobody acted on it in time**, but it no longer closes when the candidate stops qualifying. An ask for a person has no Activity row of its own. The **Asked for an accommodation** row appears only after an Accommodation Requested run starts. With nothing wired, a welcome-page click or an interview ask leaves no Activity trace, and a text ask shows only as the message itself.

> [!NOTE]
>
> Shared reports show the Activity of the candidate like the rest of their Activity, with contact details removed, including the rows for these asks.

## What happens when an item closes

An item closes when it's handled, whether you did it in the Inbox, somewhere else in Alex, or in your ATS. You don't have to clear items by hand when the work is already done.

A closed item moves to everyone's **Done**. Open it and a green banner says how it closed, who closed it, and when, for example "Replied by Jordan Lee · 2:41 PM". If a teammate closes the item while you have it open, you see **Handled by a teammate** and can move on with **Next**.

Closing is shared, so nothing reopens an item for everyone. If the candidate needs something again later, a new item opens. To keep working a closed item yourself, use [Mark To do](https://docs.alex.com/inbox/using-your-inbox.md#mark-to-do): it's reopened for you only.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.