# Personalized Accommodation

<div align="center"><figure><img src="https://4249329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE2a888ltdx6dUekSgs4U%2Fuploads%2FJB8oEWUCVKcAB1DA6ZnY%2FIMG_0A264F0CCAFB-1.jpeg?alt=media&#x26;token=6fe4f323-f1fa-401a-a6e5-b23f0ff856a9" alt="" width="188"><figcaption><p>Personalized accommodation in the Tour Guide App</p></figcaption></figure></div>

Each release can include booking-specific accommodation details visible to travelers in the Tour Guide App:

| Field              | Description                                                  |
| ------------------ | ------------------------------------------------------------ |
| **Arrival date**   | Check-in date for this accommodation                         |
| **Departure date** | Check-out date for this accommodation                        |
| **Comment**        | Booking-specific notes (e.g. "Breakfast included, 3 adults") |

{% hint style="warning" %}
Arrival and departure dates are mandatory for the trip overall **and** for each individual accommodation.
{% endhint %}

### Automated day/stage category mapping

GUIBO can automatically place each hotel as start/end accommodation within the correct day/stage category. Two prerequisites are required:

1. **Each day/stage category has a destination POI**\
   Add POI → Display → Icon → `destination`
2. **An arrival day category exists** with its own destination POI

Hotels are assigned to the stage whose destination POI is closest — there is no distance limit. If two destinations are equidistant, the hotel is added to both. Each hotel displays at the **start of the following day**, so each stage shows a hotel at both start and end.

{% hint style="danger" %}
Manage all destinations for all guidebooks in **one shared library**. Linking from a single library (instead of re-creating destinations per guidebook) ensures consistent hotel-to-destination distances across products with shared stages.&#x20;
{% endhint %}

#### Setting destination points — best practice

1. **Create a dedicated destination library** to maintain unique destination points across all guidebooks.
2. Open your guidebook and click **Edit Content** to access the content builder.
3. Click the **map icon** to view all existing destination points from your libraries.
4. **Import an existing destination point** by clicking the relevant map icon.
5. To **create a new destination point:**
   * Click the respective stage on the left
   * Click **Add Item → Add Markers**
   * Set the destination point on the map
   * Save it to your destination library

### Add personalized accommodations to your releases

{% tabs %}
{% tab title="Add accommodations via Webportal" %}

* Go to the **Release Dashboard**
* On the right side at the bottom, open the **accommodation tab**
  * See all accommodations for this releases
  * Add accommodations for this release

<figure><img src="https://4249329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE2a888ltdx6dUekSgs4U%2Fuploads%2FpLpCMBzD7t3QJ22Q8N6n%2Fimage.png?alt=media&#x26;token=ed1f0ec4-06d6-4400-8eaf-bf12c41c3645" alt=""><figcaption><p>How to add accommodations in the release dashboard</p></figcaption></figure>
{% endtab %}

{% tab title="Add accommodations via API" %}

#### Update API-Integration

#### 1. Release arrival and departure dates

Update your API integration to include booking dates for the overall trip when creating releases:

```json
...
"arrivaldate":"2025-01-22",
"departuredate": "2025-01-25"
...
```

#### 2. Accommodation details

Provide the arrival date, departure date as well as any comment or description along with the accommodation POI as follows.

```json
...
 "accommodation": [
           {
               "externalId":"HPO1",
               "libraryExternalId":"HOTELS",
               "arrivalDate":"2025-09-05",
               "departureDate":"2025-09-06",
               "comment":"A generous breakfast buffet is included"
               
           }
       ]
```

Click here for an end-to-end example:[#b-create-download-permission-with-customization](https://docs.guibo.travel/developers/releases-api/release-or-create-guidebook-release#b-create-download-permission-with-customization "mention")
{% endtab %}
{% endtabs %}