> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/hablla-docs-en/hablla/settings/holidays.md).
# Holidays
## Holidays
The feature **Holidays** allows you to register specific dates on which your operation will be unavailable, even if those dates fall within the normally configured business hours.
It can be used both for **national, state, or municipal holidays** as well as for other special dates on which your operation will not provide service.
For example, imagine your operation normally runs from **Monday to Friday, from 9:00 a.m. to 6:00 p.m.**. If there is a holiday on a Wednesday, you can register that date so that Hablla considers that day as **outside working hours**, even though service would normally be available during that period.
> **Important**
>
> Registering a holiday by itself **does not change how your flows work**.
>
> For the registered dates to be considered, the flow must use the component **Working Hours** and the validation option for **Holidays** must be enabled in that component's settings.
### When should you use Holidays?
Besides conventional holidays, the feature can be used to represent any exceptional date on which your operation will not be available.
Some examples:
* National holidays;
* State or municipal holidays;
* Recesses;
* Commemorative dates on which there will be no business hours;
* Company-wide days off;
* Other specific dates when the operation is unavailable.
The feature is especially useful when the unavailability occurs on a day that **would normally be part of your working hours**.
For example, if your operation already does not work on Saturdays and Sundays, you generally will not need to register a holiday that falls on a weekend, since the Working Hours component would already consider that period outside business hours.
## How to register a Holiday
### 1. Access the Holidays settings
Within the **Hablla Studio**, click the **gear**icon located in the upper-right corner of the screen to access your workspace settings.
In the left sidebar, locate and click the option **Holidays**.
### 2. Add a new Holiday
On the **Holidays**, click the button **+ Add Holiday**, located in the upper-right corner.
A new window will appear with three fields for configuration:
* **Holiday Name**
* **Description**
* **Date**
#### Holiday Name
Enter a name that makes it easy to identify the registered date.
For example: `Independence of Brazil`
The name can also be used in more advanced implementations within Automation Flows. This makes it possible, for example, to create dynamic messages informing the customer why there will be no service that day.
> **Example**
>
> "Due to the Independence of Brazil holiday, we will not be available today. We will return on the next business day."
Using this information dynamically requires knowledge of **Variables and Expressions in Automation Flows** which you can check [by clicking here](/hablla-docs-en/automation-flows/using-variables.md).
#### Description
Use this field to add additional information that makes it easier to identify the registered date. For example: `National Holiday` or `Municipal Holiday`.
#### Date
Select the **date on which your operation will be unavailable**. After filling in the three fields, click **Save**.
Done! The date will be registered in your workspace settings.
## Using Holidays in Flows
For the registered holidays to be effectively considered by your automation, the flow must use the component **Working Hours**.
In that component's settings, enable the option responsible for considering the **Holidays**.
From this configuration onward, whenever the component is executed, Hablla will check:
1. Whether the execution time is within the configured working hours;
2. Whether the current date matches any of the registered holidays.
When the date is registered as a holiday, the component will consider that moment as **outside working hours**, even if the day and time normally fall within business hours.
```mermaid
flowchart LR
A["Flow"] --> B["Working Hours"]
B --> C{"Is it a holiday?"}
C -->|"No"| D["Within hours"]
C -->|"Yes"| E["Outside hours"]
```
The flow will then continue through the corresponding output for **Outside Working Hours**, allowing you to define the appropriate behavior for that period.
> **Attention**
>
> Remember that the holidays registered in the workspace settings **will only be considered in flows where Holiday validation is enabled in the Working Hours component**.
### All set!
With this configuration, you can keep your standard business hours and register only the **calendar exceptions** of your operation.
When one of the registered dates arrives, flows configured to consider holidays will automatically recognize the unavailability and continue through the output of **Outside Working Hours**.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.hablla.com/hablla-docs-en/hablla/settings/holidays.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
