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

# Communication Policies

> Control how and when HeyMilo contacts candidates throughout the hiring process.

**Where to find it:** Sidebar → Communication Policies

<video src="https://storage.googleapis.com/heymilo-pub-docs/videos/407eb5b8-8cb8-4672-bc50-841b13e4406f%20(1).mp4" controls />

## What it does

Communication Policies let you control how and when HeyMilo reaches out to candidates throughout the interview process. You can set nudge timing, business hours, lifecycle emails, and agent-specific overrides — then apply a policy to one or many interviewers.

<Frame>
  <img src="https://mintcdn.com/heymilo/jd5oSjXEZpv_ztmM/images/communication-policies-overview.png?fit=max&auto=format&n=jd5oSjXEZpv_ztmM&q=85&s=2ad26e531d3f529014b42ba8e93041d7" alt="Communication Policies overview" className="mx-auto" width="1024" height="393" data-path="images/communication-policies-overview.png" />
</Frame>

Every workspace starts with a **Default Policy**. You can edit it or create additional policies for different use cases (e.g. high-touch outreach, specific client workflows, or different time zones).

## Creating a policy

**Communication Policies → Create Policy**

<Frame>
  <img src="https://mintcdn.com/heymilo/jd5oSjXEZpv_ztmM/images/communication-policies-create.png?fit=max&auto=format&n=jd5oSjXEZpv_ztmM&q=85&s=5f53d2d039b572eebec0c2fcb8fe8743" alt="Create a communication policy" className="mx-auto" style={{ width: "60%" }} width="894" height="1024" data-path="images/communication-policies-create.png" />
</Frame>

Give it a name and an optional description so your team knows when to use it.

## Policy settings

### Master switches

| **Toggle**             | **What it controls**                                                  |
| ---------------------- | --------------------------------------------------------------------- |
| **All communications** | Turns all candidate-facing communications on or off for this policy   |
| **All nudges**         | Turns all nudge messages on or off without affecting lifecycle emails |

### Global timing

| **Setting**                  | **What it does**                                                         |
| ---------------------------- | ------------------------------------------------------------------------ |
| **Nudge cooldown (hours)**   | Minimum time between nudges sent to the same candidate                   |
| **Candidate max age (days)** | Stops nudging candidates who have been in the pipeline longer than this  |
| **Business hours**           | Start time, end time, and timezone — nudges only send within this window |

### Nudge settings by agent type

By default, all agents use system nudge defaults. Use **Add Override** to customize nudge behavior for specific agent types:

* **Web Interview Reminders** (Sarah): nudges to complete the video/web interview
* **SMS Follow-ups** (Tyler): SMS nudges and conversational follow-ups
* **Resume Screening Reminders** (Roscoe): nudges to submit resume for screening
* **Form Reminders:** nudges to complete application forms
* **AI Scenario Assessment Reminders:** nudges to complete AI scenario assessments

Only the agent types you add here will have custom settings. All others continue using system defaults.

### Lifecycle emails

| **Setting**            | **What it does**                                                                                                                                      |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Deadline reminders** | Sends reminder emails before an interview deadline. Set the window (how many days before the deadline to start and stop) and max number of reminders. |
| **Completion email**   | Sent when a candidate completes their interview                                                                                                       |
| **Retake email**       | Sent when a candidate is allowed to retake                                                                                                            |
| **Scheduling email**   | Sent when scheduling is involved                                                                                                                      |
| **Report email**       | Sends the interview report to the candidate                                                                                                           |

Each can be toggled on or off independently.

## Applying a policy to an interviewer

<Frame>
  <img src="https://mintcdn.com/heymilo/jd5oSjXEZpv_ztmM/images/communication-policies-link.png?fit=max&auto=format&n=jd5oSjXEZpv_ztmM&q=85&s=ac9d0e0b1c34a46b69de124aeba758d3" alt="Linking a policy to an interviewer" className="mx-auto" width="1024" height="527" data-path="images/communication-policies-link.png" />
</Frame>

Once a policy is created, link it to one or more interviewers. Open the policy → **Linked Interviewers** to manage which interviewers use it.

## Default policy

Every workspace has one default policy. It applies to any interviewer that doesn't have a specific policy assigned. To change the default, open the policy menu and select **Remove as Default** or set a different policy as default.
