# Holidays Parameters

When you export your holidays, or build a file to add them in bulk, Cloud Voice reads and writes a CSV (Comma-Separated Values) file whose columns depend on how each holiday is scheduled. Every row starts with the same two identifying fields, and the remaining columns you fill in are determined by the holiday type you choose.

:::tip
If you are unsure of the exact column headers or their order, export your existing holidays first. Cloud Voice writes the file with the correct headers already in place, so that export makes a reliable template to fill in for your import.
:::

## Common fields

These columns apply to every holiday, regardless of type.

| Column | Required | Accepted values | Default |
|--------|----------|-----------------|---------|
| `Name` | Yes | Up to 127 characters. Each holiday name must be unique. | None |
| `Holiday Type` | Yes | `By Date`, `By Month`, or `By Week`. | `By Date` |

:::note
If you leave `Holiday Type` blank on a row, Cloud Voice treats it as `By Date`.
:::

The holiday type decides which of the following column sets you need to complete.

## By Date

Use these columns when `Holiday Type` is `By Date`, for a holiday that falls on a specific calendar date.

| Column | Required | Format | Default |
|--------|----------|--------|---------|
| `Start Date (By Date)` | Yes | `DD/MM/YYYY HH:MM`, for example `25/10/2020 13:30`. | None |
| `End Date (By Date)` | Yes | `DD/MM/YYYY HH:MM`, for example `25/10/2020 13:30`. | None |

:::caution
The end date must be later than the start date.
:::

## By Month

Use these columns when `Holiday Type` is `By Month`, for a holiday that recurs on the same day and month every year.

| Column | Required | Format | Default |
|--------|----------|--------|---------|
| `Start Date (By Month)` | Yes | `DD/MM HH:MM`, for example `31/10 13:30`. | None |
| `End Date (By Month)` | Yes | `DD/MM HH:MM`, for example `31/10 13:30`. | None |

:::caution
The end date must be later than the start date.
:::

## By Week

Use these columns when `Holiday Type` is `By Week`, for a holiday that recurs on a chosen weekday within a chosen week of a month.

| Column | Required | Accepted values | Default |
|--------|----------|-----------------|---------|
| `Month (By Week)` | Yes | `January`, `February`, `March`, `April`, `May`, `June`, `July`, `August`, `September`, `October`, `November`, or `December`. | None |
| `Week (By Week)` | Yes | `First Week`, `Second Week`, `Third Week`, `Fourth Week`, or `Last Week`. | None |
| `Day (By Week)` | Yes | `Sunday`, `Monday`, `Tuesday`, `Wednesday`, `Thursday`, `Friday`, or `Saturday`. | None |
| `Start Time (By Week)` | Yes | `HH:MM`, for example `13:30`. | None |
| `End Time (By Week)` | Yes | `HH:MM`, for example `13:30`. | None |

:::caution
The end time must be later than the start time.
:::