> For the complete documentation index, see [llms.txt](https://docs.cipp.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cipp.app/user-documentation/identity/administration/vacation-mode/add-vacation-schedule.md).

# Add Vacation Schedule

This wizard schedules a set of temporary changes for one or more users and the reversal of each, so a period of absence is set up once and undone automatically. Six kinds of change are available and any combination can be used, but at least one has to be enabled before the wizard will continue.

{% stepper %}
{% step %}

### Tenant Selection

The tenant the changes apply to. This defaults to the tenant selected in the top menu and can be changed here.

If the tenant has [Tenant Vacation Defaults](https://docs.cipp.app/user-documentation/tenant/manage/edit.md#tenant-vacation-defaults) saved, the Vacation Actions step starts with them filled in. See that step for how they are applied.
{% endstep %}

{% step %}

### User Selection

The users the vacation applies to. Several can be selected, and the changes below are applied to each of them.
{% endstep %}

{% step %}

### Vacation Actions

Six switches, each revealing its own settings. Enable whichever apply.

#### Enable CA Policy Exclusion

Excludes the selected users from Conditional Access policies for the duration.

| Field                                                               | Description                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Conditional Access Policies                                         | The policies to exclude the users from. At least one is required. The list is read from the tenant chosen in step one, so a tenant has to be selected before it populates.                                                                                                           |
| Create temporary travel policy                                      | Creates a named location for the travel destination and a policy that blocks sign-ins from everywhere else, then deletes both at the end date.                                                                                                                                       |
| Add users' home country (usage location) to the travel destinations | Shown with the travel policy. Adds each selected user's usage location to the travel destination countries, so they can still sign in from home. A country you remove by hand is not added back.                                                                                     |
| Travel destination countries                                        | The countries the users are travelling to. Required when a travel policy is being created.                                                                                                                                                                                           |
| Also allow sign-ins from existing named locations (optional)        | Shown with the travel policy. Named locations already in the tenant, such as an office IP range or a home country location, that the travel policy also allows sign-ins from. They are only referenced, so they are left in place when the travel policy is deleted at the end date. |
| Also allow sign-ins from all trusted locations                      | Shown with the travel policy. Also allows sign-ins from every location marked as trusted in the tenant.                                                                                                                                                                              |

{% hint style="info" %}
When the tenant has Tenant Vacation Defaults, this card shows a **Using Tenant Defaults** label and the policies, travel policy, home country and location alert switches start as saved. The defaults are applied once when the tenant is chosen, so anything you change afterwards is kept, and every setting can still be changed for this vacation. A default policy that no longer exists in the tenant is dropped, with a warning naming it.
{% endhint %}

{% hint style="warning" %}
Excluding someone from a Conditional Access policy allows sign-ins from anywhere, which is a wider gap than the trip usually warrants. The temporary travel policy is there to close it, restricting sign-ins to the destination for the same period.
{% endhint %}

#### Exclude from location-based audit log alerts

Suppresses the alerts that would otherwise fire on sign-ins from an unusual location, by putting the users on the audit log alert exclusion list at the start date and taking them off again at the end date. This stands on its own: it needs no Conditional Access policy, so tenants without any still get to quiet the alerts for the trip.

#### Add users to group(s) for the duration of the vacation

Puts the users into the chosen groups at the start date and takes them out again at the end date.

| Field    | Description                                                                                              |
| -------- | -------------------------------------------------------------------------------------------------------- |
| Group(s) | The groups to add the users to. At least one is required, and the list is read from the selected tenant. |

Users who are already members of a group are left untouched, and only users who were added for the vacation are removed at the end date. Dynamic membership groups cannot take direct members, and the wizard warns when one is selected.

#### Enable Mailbox Permissions

Grants delegates temporary access to the users' mailboxes.

| Field                        | Description                                                                                                                                                                                       |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Delegates                    | The users receiving access. At least one is required.                                                                                                                                             |
| Permission Types             | Any combination of `Full Access`, `Send As`, and `Send On Behalf`. At least one is required.                                                                                                      |
| Auto-Map Mailbox             | Lets Outlook add the mailbox on its own for the delegate. Offered with `Full Access`.                                                                                                             |
| Include Calendar Permissions | Grants access to the calendar as well as the mailbox.                                                                                                                                             |
| Calendar Permission Level    | The access level on the calendar: `Owner`, `Publishing Editor`, `Editor`, `Publishing Author`, `Author`, `Non Editing Author`, `Reviewer`, `Contributor`, `Limited Details`, or `Available Only`. |
| Can View Private Items       | Allows the delegate to see items marked private.                                                                                                                                                  |

#### Enable Mail Forwarding

Forwards the users' mail for the duration.

| Field                                                     | Description                                                                    |
| --------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Forward to Internal Address / Forward to External Address | Whether mail goes to another recipient in the tenant or to an outside address. |
| External Email Address                                    | The outside address to forward to.                                             |
| Keep a Copy of the Forwarded Mail in the Source Mailbox   | Delivers the message to the user's own mailbox as well as forwarding it.       |

{% hint style="warning" %}
Forwarding is turned off at the end date rather than returned to how it was. Any forwarding the mailbox had configured beforehand is not restored, so check that first if the user already had a forward set.
{% endhint %}

#### Enable Out of Office

Sets automatic replies for the duration.

| Field                                                    | Description                                                                                                       |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Internal Message                                         | The reply sent to people inside the organisation. Pre-filled with the mailbox's current message where one is set. |
| External Message (optional)                              | The reply sent to people outside the organisation.                                                                |
| Block my calendar for this period                        | Creates a calendar event covering the absence, with a subject of your choosing.                                   |
| Automatically decline new invitations during this period | Declines invitations arriving during the absence.                                                                 |
| Decline and cancel my meetings during this period        | Declines and cancels meetings already booked, with an optional message to organisers.                             |

{% hint style="info" %}
Turning automatic replies off at the end date preserves whatever the message says at that point, so a user who edits their own reply while away does not have it overwritten.
{% endhint %}
{% endstep %}

{% step %}

### Schedule

| Field                  | Description                                                                                                                                                                                              |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Scheduled Start Date   | When the changes are applied.                                                                                                                                                                            |
| Scheduled End Date     | When they are reversed.                                                                                                                                                                                  |
| Post Execution Actions | Which channels are notified as the tasks run: Webhook, Email, PSA, or Push (a notification to your own registered devices).                                                                              |
| Reference              | Free text carried onto every task the vacation creates, which is what ties them together on the [Vacation Mode](https://docs.cipp.app/user-documentation/identity/administration/vacation-mode.md) page. |
| {% endstep %}          |                                                                                                                                                                                                          |

{% step %}

### Review & Submit

A summary of everything selected. Submitting creates the scheduled tasks.
{% endstep %}
{% endstepper %}

***

## Feature Requests / Ideas

We value your feedback and ideas. Please raise any [feature requests](https://github.com/CyberDrain/CIPP/issues/new?template=feature.yml) on GitHub.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cipp.app/user-documentation/identity/administration/vacation-mode/add-vacation-schedule.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
