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

# Interviews

> Once a candidate is worth a closer look, you schedule an interview.

Once a candidate is worth a closer look, you schedule an interview. In Hitaji 360 an interview is more than a calendar entry: it holds the **panel** (the people doing the interviewing), the **competencies** they will score, each interviewer's **scorecard**, and the **decision** that either advances the candidate towards an offer or ends their journey. The whole thing is built so a hiring manager can open one screen and see how every panelist rated the candidate, where they agreed, where they didn't, and what the data suggests they should do.

This page covers scheduling an interview, the panel and competencies, how interviewers submit scorecards, the interview's statuses, and recording the final decision.

**You'll find this at:** `/hr/recruitment/interviews` (list & calendar), `/hr/recruitment/interviews/:id` (detail)

> 📷 *Screenshot: Interviews list with the status stat cards and the Table / Calendar toggle — to be added.*

***

## Before you start

* **Which business am I in?** Interviews belong to the business selected in the switcher. The list and calendar only show interviews for the currently selected business, and one business cannot see another's.
* **You schedule an interview against an applicant.** Every interview is tied to a [job applicant](/hr/user/recruitment/job-applicants); you can't schedule one in the abstract.
* **Each interview gets a reference number** automatically (e.g. `INT-2026-0001`), shown as the **ID** on the list.

***

## The interview lifecycle (statuses)

| Status           | Meaning                                                                | What you can do                                           |
| ---------------- | ---------------------------------------------------------------------- | --------------------------------------------------------- |
| **Pending**      | Scheduled, not yet decided.                                            | Reschedule, submit scorecards, cancel, record a decision. |
| **Under Review** | Scorecards are coming in / being weighed.                              | Submit more scorecards, cancel, record a decision.        |
| **Cleared**      | Final decision: the candidate passed this interview. A terminal stage. | Nothing further.                                          |
| **Rejected**     | Final decision: the candidate did not pass. A terminal stage.          | Nothing further.                                          |
| **Cancelled**    | The interview was called off. A terminal stage.                        | Nothing further.                                          |

You can **cancel** only an interview that is still **Pending** or **Under Review**. Once an interview is **Cleared**, **Rejected**, or **Cancelled** it is terminal — no more scorecards, no decision changes.

***

## Two ways to view interviews

A **Table / Calendar** toggle sits above the list:

* **Table** — every interview with its ID, candidate, position, scheduled date and time, the **panel** (overlapping interviewer avatars), status, and average rating. Click any row to open the interview. A small cancel button appears on rows that are still Pending or Under Review.
* **Calendar** — the same interviews laid out on a calendar by their scheduled date, colour-coded by status.

Above the views sit five clickable **stat cards** — Pending, Under Review, Cleared, Rejected, Cancelled — that filter the list by status. There's also a search box (search by candidate name or designation) and an advanced status filter.

***

## Scheduling an interview

Choose **Schedule Interview** (needs `hr-recruitment:write`) from the interviews list, or **Schedule** from a candidate's [applicant detail page](/hr/user/recruitment/job-applicants).

> 📷 *Screenshot: Schedule Interview dialog — to be added.*

| Field                     | Required | Notes                                                                                                                                                                            |
| ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Applicant**             | Yes      | The candidate. Pre-filled when you start from the applicant page.                                                                                                                |
| **Interview type**        | No       | Pick a configured [interview type](/hr/user/recruitment/interview-types) (e.g. "Technical Round"). Choosing one **seeds** the panel and competencies from that type — see below. |
| **Competencies to score** | No       | The skills each panelist rates on a 1–5 star scale. Type one and press Enter (or **Add**). Seeded from the interview type if you picked one; you can tailor them for this round. |
| **Scheduled date**        | Yes      | The day of the interview.                                                                                                                                                        |
| **From time / To time**   | No       | The interview window.                                                                                                                                                            |
| **Designation**           | No       | The role being interviewed for.                                                                                                                                                  |
| **Interviewers**          | No       | Search and add the people on the panel. Seeded from the interview type if you picked one; add or remove freely.                                                                  |

> **The interview type is a head start, not a cage.** Picking a type pulls in its default interviewers and competencies, but everything stays editable for this particular round — add a competency, drop an interviewer, whatever this interview needs.

***

## The interview detail page

Opening an interview gives you the control room for that round.

> 📷 *Screenshot: Interview detail with the panel rail, scorecards, and decision panel — to be added.*

At the top, a **status pipeline** shows where the interview sits (Pending → Under Review → Cleared, or a Rejected / Cancelled track). The header carries a **Cancel interview** button while the interview is still open.

### The panel & scorecards

Each interviewer on the panel gets a **scorecard**. The page shows a **panel rail** (who's on the panel and who has submitted) and a **Scorecards** tab listing every submitted scorecard with that interviewer's competency ratings and their recommendation.

If **you** are on the panel and the interview is still open, you'll see a banner cueing you to submit:

* **Before the interview day**, the banner is informational — your scorecard "opens on" the scheduled date.
* **On or after the interview day**, the banner turns into a prompt with a **Submit scorecard** button.
* **After you've submitted**, the banner shows your score and recommendation with an **Edit scorecard** button.

The scorecard form (see *Submitting feedback* below) lets you rate each competency on a 1–5 star scale, choose **Cleared** or **Rejected** as your recommendation, and add free-text feedback.

### Skill analysis

The **Skill analysis** tab shows a **competency consensus** matrix: how the panel scored each competency on average and where they disagree. This is what turns several opinions into a defensible decision.

### Overview & summary

The **Overview** tab shows the interview type, designation, scheduled date and time, the **expected average** (the bar set on the interview type), and the **actual average** the panel gave. There's an editable **interview summary** note — click it to type, then **Save**.

### Candidate & decision rail

On the right, a **Candidate** card links to the [full applicant profile](/hr/user/recruitment/job-applicants). Below it, a **Decision** panel summarises the panel's consensus, the actual versus expected average, and a **suggested decision** — then lets an approver record the outcome.

***

## Submitting feedback (scorecards)

Feedback is submitted by the panelists themselves. Each scorecard records:

| Field                  | Notes                                                               |
| ---------------------- | ------------------------------------------------------------------- |
| **Result**             | **Cleared** or **Rejected** — your recommendation on the candidate. |
| **Competency ratings** | A star rating per competency the round is assessing.                |
| **Feedback**           | Free-text notes.                                                    |

A few rules worth knowing:

* A scorecard is **auto-submitted** the moment you create it — there is no separate draft step.
* You can **edit** or **withdraw** your own scorecard while the interview is still open (both need `hr-recruitment:write`).
* As scorecards come in, the interview's **average rating** updates, and the panel rail and consensus matrix fill out.

***

## Recording the decision

When the panel has weighed in, an approver records the outcome from the **Decision** panel: **Cleared** or **Rejected**. This needs `hr-recruitment:approve`.

* **Cleared** moves the candidate forward — typically towards a [job offer](/hr/user/recruitment/job-offers).
* **Rejected** ends the candidate's journey for this round.

The decision finalises the interview (it becomes terminal), and the suggested-decision hint on the panel exists precisely so the approver isn't deciding blind.

> Recording a decision does **not** by itself change the applicant's pipeline stage to Accepted — a candidate only becomes **Accepted** when they accept a [job offer](/hr/user/recruitment/job-offers). The interview decision is the signal to *make* that offer.

***

## Cancelling an interview

**Cancel interview** is available on any interview still in **Pending** or **Under Review**, from either the list (the small cancel button on a row) or the detail header. It needs `hr-recruitment:approve`. A cancelled interview becomes terminal.

***

## Permissions

| Action                                                                        | Permission               |
| ----------------------------------------------------------------------------- | ------------------------ |
| View interviews, the calendar, scorecards, and analysis                       | `hr-recruitment:read`    |
| Schedule, reschedule, edit an interview, submit / edit / withdraw a scorecard | `hr-recruitment:write`   |
| Record a decision (Cleared / Rejected), submit (finalise), cancel             | `hr-recruitment:approve` |

***

## Related

* [Job applicants](/hr/user/recruitment/job-applicants) — the candidates you interview
* [Interview types](/hr/user/recruitment/interview-types) — reusable round definitions (panel + competencies)
* [Job offers](/hr/user/recruitment/job-offers) — what a cleared candidate moves towards
* [Recruitment overview & dashboard](/hr/user/recruitment/overview) — the interview KPIs in context