# Accommodation Types

![accom-menu-item.png](./attachments/accom-menu-item.png)

* * *

<a id="create-a-new-accommodation"></a>

## Create a new accommodation

You can create as many accommodation types as you need. For each accommodation type (for example "Double room"), you will be able to set how many you have of this type (for example "10" Double rooms).

- Click “Add New” Accommodation

![new-accom.png](./attachments/new-accom.png)

- Enter the Accommodation title and the Accommodation description. You can use shortcodes or blocks to display a search form, a rate table, an availability calendar...

![content.png](./attachments/content.png)

![content-gut.png](./attachments/content-gut.png)

1. Enter the **Accommodation title**. This is the name of the accommodation type, as it will appear on front-end. You can create a different admin name.
2. You will see the accommodation ID here. You might need it when using the shortcodes.
3. If you wish to use the default HBook Accommodation post to display your accommodation page, please enter the content of the post here. You can add HBook shortcodes to add an availability calendar, a rate table or a search form.

> [!INFO]
> By default, if a shortcode is added within the accommodation post, it is applied for this accommodation type.

* * *

<a id="set-the-featured-image"></a>

### Set the featured image

If you wish, you can set a Featured image that will appear as the accommodation thumbnail in the search results and in the accommodation list.

![featured.png](./attachments/featured.png)

<a id="general-settings"></a>

## General settings

The settings are here to provide HBook with the information needed for the booking system. **Normal occupancy**, **Maximum occupancy** and **Number of accommodation of this type** are the only required settings for HBook to work.

![general-settings.png](./attachments/general-settings.png)

1. Indicate the **number of accommodation of this type** (required)
2. If you have several units for an accommodation type, you might wish to give different names/numbers than the default numbering. If you click **Edit accommodation numbering**, you will be able to rename the accommodation for that Accommodation type.

* * *

<a id="occupancy-settings"></a>

## Occupancy settings

![occupancy-settings.png](./attachments/occupancy-settings.png)

1. Enter the **normal occupancy** (required): this is the number of people the accommodation rate (as set in **HBook > Rates**) is for.
2. Enter the **maximum occupancy** (required): this is the maximum number of persons the accommodation can cater for.
3. Enter the **minimum occupancy** (optional): if you wish to set a minimum number of persons for the accommodation type, please enter it here.
4. You can specify a **maximum number of adults** or **children** for this accommodation type.

**If your prices change according to the number of persons:**

- You will use the **normal occupancy** to set the number of persons for which your base rate is (set in "Accommodation rate" in **HBook > Rates**). And you will set the "Maximum occupancy" to the greatest number of persons the accommodation can accept
- You will then set in **HBook > Rates** the "Price per adult above normal occupancy" and "Price per child above normal occupancy".

<a id="examples-of-occupancy-settings"></a>

### Examples of Occupancy settings

> [!NOTE]
> **Example 1 - Rate per accommodation independently of the number of guests**
> In this example, we have a Triple Room that can be occupied by 2 persons or 3 persons. The rate is $75 per room in Winter season and $95 per room in Summer season (be it for 2 or 3 persons).
> ![accom-occupancy-example1.png](./attachments/accom-occupancy-example1.png)
> - Normal occupancy and maximum occupancy are set to the maximum number of persons the accommodation type is for.
> - Minimum occupancy is set to 2 to prevent this room to show up in the results in the search is for 1 guest only.
> ![occupancy-rate-example1.png](./attachments/occupancy-rate-example1.png)
> - In **HBook > Rates**, we use only the “Accommodation rate” as there is no need to define prices for people beyond normal occupancy, since the price does not vary according to the number of guests.

> [!NOTE]
> **Example 2 - Base rate for the accommodation and rate for extra-persons**
> In this example, we have an apartment that is rented per week for maximum 4 persons ; price is the same for 1 or 2 persons but 3rd and 4th persons need to pay an extra fee.
> ![accom-occupancy-example2.png](./attachments/accom-occupancy-example2.png)
> - Normal occupancy is set at 2 persons and maximum occupancy is set to 4 persons (this will allow us to define the price for up to 2 persons and for each additional guest).
> ![occupancy-rate-example2.png](./attachments/occupancy-rate-example2.png)
> - In **HBook > Rates**, you will set the “Accommodation rate” as being the rate for up to 2 persons, and you will set the "Price per adult/children above normal occupancy" to set the price for the additional guests.

> [!NOTE]
> **Example 3 - Rate is per person, not per accommodation**
> In this example, we have a family apartment that can accommodate between 2 and 5 persons. The price is per person: an adult will pay $50 per night and a child will be charged $30 per night.
> ![accom-occupancy-example4.png](./attachments/accom-occupancy-example4.png)
> - Normal occupancy is set at 1 person and maximum occupancy is set to 5 persons (this will allow us to define a price per person).
> - Minimum occupancy is set at 2 persons.
> ![occupancy-rate-example4.png](./attachments/occupancy-rate-example4.png)
> - In **HBook > Rates**, you will set the "Accommodation rate” as the rate for 1 adult.
> - Then, you will set the "Price per adult above normal occupancy" at $50 (price per adult) and the "Price per children above normal occupancy" at $30 (price per child).

> [!NOTE]
> **Example 4 - Accommodation with a minimum occupancy**
> In this example, we have a holiday home that can be rented per room or entirely. We have created an accommodation type "Entire holiday home" but we don't want to offer it for less than 5 persons. Therefore, the accommodation type should not be shown in the results if the search is for less than 5 persons: minimum occupancy is set to 5.
> ![accom-occupancy-example3.png](./attachments/accom-occupancy-example3.png)

* * *

<a id="descriptions"></a>

## Descriptions

![descriptions.png](./attachments/descriptions.png)

1. Enter the **description displayed in searched results** (optional): it will be shown in the result of a search when using [\[hb\_booking\_form\]](../hbook-documentation/shortcodes-blocks/booking-form.md).
2. Enter the **description displayed in Accommodation list** (optional): it will be shown when using [\[hb\_accommodation\_list\]](../hbook-documentation/shortcodes-blocks/accommodation-list.md).
3. You can give an **accommodation short name** to the accommodation to be used in the calendar of reservations in **Reservations**. This can be useful if you have a long accommodation title to simplify the display in the calendar.
4. You can as well indicate the **accommodation abbreviated name**. It will be used in mobile view of the calendar of reservations in **Reservations**.

* * *

<a id="display-options"></a>

## Display options

![display-1.png](./attachments/display-1.png)

1. Set your preferences regarding the **display** of your accommodation type. HBook allows you to either :
  - use HBook default accommodation post type
  - apply one of your page template
  - or use a different page/post to showcase the accommodation type
2. Enter a **starting price** (optional): it will be shown in the list of accommodation when using [\[hb\_accommodation\_list\].](../hbook-documentation/shortcodes-blocks/accommodation-list.md)

<a id="using-the-hbook-accommodation-type-post"></a>

### Using the HBook **accommodation type post**

![display-2.png](./attachments/display-2.png)

1. You will set that you wish to use this post to display the accommodation...
2. ... and you can choose which **template** you wish to apply

<a id="using-another-post-or-page-for-display-purposes"></a>

### Using **another post or page** for display purposes

![display-3.png](./attachments/display-3.png)

1. You will set that you wish to use another post or page to display the accommodation...
2. ... and you will enter the **ID** of the page or post to be used instead.

> [!INFO]
> Please refer to [this help article](https://maestrel.atlassian.net/wiki/spaces/KB/pages/52723967/How+to+find+the+Page+or+Post+ID) to check where to find the Page or Post ID.

**Choosing to use a different post or page for display has several effects:**

- You can then use HBook shortcodes on the page you use for display without specifying the "accom\_id" parameter. HBook will know what accommodation type is concerned.
- At the accommodation selection step of the booking process, the "View accommodation" button will redirect to the page set to be used for display.
- At the accommodation selection step of the booking process, if you have set that the thumbnail and title of the accommodation type should link to the accommodation page, it will open the page set to be used for display.
- In the accommodation list, if you have set that the thumbnail should link to the accommodation page, it will open the page set to be used for display.

* * *

<a id="automatic-blockings"></a>

## Automatic blockings

![blockings.png](./attachments/blockings.png)

1. Indicate the **preparation time**. HBook will automatically block x days before check-in and after check-out of a reservation.
2. Indicate the **linked accommodation**: you will enter here the accommodation ids of the accommodation that need to be blocked automatically when the accommodation type you currently edit is booked. If you need to specify the number of accommodations that need to be blocked for each linked accommodation type, you can add that number in ().

> [!INFO]
> Note that if you need to **link accommodations both ways** (if one is booked, the other is blocked automatically and vice versa), you will need to enter for each accommodation type the accommodation ID of the other type.

<a id="examples-of-linked-accommodation-settings"></a>

### Examples of linked accommodation settings

> [!NOTE]
> **Example 1 - Blocking one accommodation**
> ![linked-accom-example1.png](./attachments/linked-accom-example1.png)
> When there is a booking for this accommodation type, one accommodation of the accommodation type with ID “2” is blocked automatically for these dates.

> [!NOTE]
> **Example 2 - Blocking one accommodation of various accommodation types**
> ![linked-accom-example2.png](./attachments/linked-accom-example2.png)
> When there is a booking for this accommodation type, one accommodation of the accommodation type ID 2, one accommodation of the accommodation type ID 3 and one accommodation of the accommodation type ID 4 are blocked automatically for these dates.

> [!NOTE]
> **Example 3 - Blocking several accommodations of various accommodation types**
> ![linked-accom-example3.png](./attachments/linked-accom-example3.png)
> When there is a booking for this accommodation type, three accommodations of the accommodation type ID 2 and five accommodations of the accommodation type ID 3 are blocked automatically for these dates.

* * *

<a id="multiple-accommodation-booking"></a>

## Multiple accommodation booking

![accom-multiple-booking.png](./attachments/accom-multiple-booking.png)

Indicate if you wish to **exclude** or not the accommodation from multiple accommodation bookings.

- When set to "Always", HBook will never show this accommodation when several accommodations are needed to accommodate the number of persons searched.
- When set to "On global search only", HBook will not show this accommodation when several accommodations are needed in a global search form. But, on a search form for this specific type of accommodation, it will be possible to book several accommodations of this type, if the number of persons searched can be accommodated.
- When set to "Never", HBook will never show this accommodation in the search results when several accommodations are needed to accommodate the number of persons searched.

> [!INFO]
> See [here](https://maestrel.atlassian.net/wiki/spaces/KB/pages/33521710/How+does+multiple+accommodation+booking+work) in our knowledgebase for more information regarding multiple accommodation booking.

* * *

<a id="setting-specific-opening-dates-for-an-accommodation-type"></a>

## Setting specific opening dates for an Accommodation Type

> [!INFO]
> You can set your default opening dates in **HBook > Misc > Opening dates**

HBook allows you to indicate specific opening dates per accommodation type.

![override-opening-dates.png](./attachments/override-opening-dates.png)

1. Enter the **minimum selectable date**. It is the first bookable date and it can be set as a **fixed date** or as a **number of days** ahead of the current date.
2. Enter the **maximum selectable date**. It can be a **fixed date** or a **number of months ahead.**