# Announcements

***

### What is an announcement? 

An announcement is a special card in the app that catches a guest's attention. It consists of a `title`, `nickname`, and `body`. Optionally, you can attach a `Call to Action (CTA)` to navigate the guest to a specific part of the app or web. 

<figure><img src="/files/2djSP3EGeR33aPhZ5D3T" alt=""><figcaption><p>Wifi Annoouncement card example</p></figcaption></figure>

#### Meta fields&#x20;

The use of [metafields](#metafields) is allowed in the `title,` `body`, and the `CTA Url.`&#x20;

{% hint style="info" %}
If meta fields are used and the announcement is shown through the public section, reservation-connected meta fields will default to their default value.&#x20;
{% endhint %}

### Announcement Types

To facilitate all kinds of announcements, we have split them up into types. Below is a list of all types and their purposes. &#x20;

<table><thead><tr><th width="296">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>Amenity</code></td><td>It is connected to a specific amenity and guides the guest through a CTA.</td></tr><tr><td><code>Guidebook</code></td><td>It is connected to a specific guidebook and guides the guest through a CTA to that guidebook.</td></tr><tr><td><code>Experience</code></td><td>It is connected to a specific experience and guides the guest through a CTA to that experience.</td></tr><tr><td><code>Native Browser</code></td><td>Guides the guest to an external page. The user is moved outside the app into a natvie browser on the mobile version. </td></tr><tr><td><code>In App Browser</code></td><td>Guides the guest to an external page. The mobile app opens a modal; in the web version, this opens a page within the default browser. </td></tr><tr><td><code>Wifi</code></td><td>This gives the user special information/instructions about the wifi. The CTA button connects the user automatically to the Wifi.</td></tr><tr><td><code>Generic</code></td><td>This generic card displays a title and a body to the guest. </td></tr></tbody></table>

All announcements have an `nickname`this helps you internally identiy what the announcement is for.&#x20;

### Dismissing

It is connected to a specific guidebook and guides the guest through a CTA to that guidebook. Announcements can be dismissed, meaning that certain announcements can be closed by the guest. Each announcement has a dismissable toggle that determines if the guest is able to close the announcement.

Dismissing announcements are only available in non-public reservation stages.&#x20;

<figure><img src="/files/rDVrTJzCRUfuJjXPI6WK" alt=""><figcaption><p>Dismissable announcements</p></figcaption></figure>

{% hint style="info" %}
Dismissed announcements cannot be retrieved by the guest and not reinstated by the operator.&#x20;
{% endhint %}

### Branding

Announcements are colored by the branding setting. To make them stand out, we alter between colors.&#x20;

<figure><img src="/files/36vmGtiJyI3m4NddVxhJ" alt=""><figcaption><p>Announcement design structure.</p></figcaption></figure>

<table><thead><tr><th width="108">#</th><th>Description</th></tr></thead><tbody><tr><td><code>1</code></td><td>The card it self is a gradient from the <code>base90</code> color to the <code>card-even</code>or the <code>card-odd</code>color. </td></tr><tr><td><code>2</code></td><td>The dismissable button background is a <code>base30</code>with a <code>base</code> colored icon. </td></tr><tr><td><code>3</code></td><td>The text is the <code>on-base</code> color</td></tr><tr><td><code>4</code></td><td>The CTA has the <code>secondary</code> background color and the <code>on-secondary</code> color. </td></tr></tbody></table>

See the [branding appearance](/the-basics/brands/appearance.md) for more details on the colors and color variants generation.&#x20;

### Connected Resources

You can connect resources like [experiences](/the-basics/experiences.md), [guidebooks](/the-basics/guidebooks.md), and [amenities](/the-basics/amenities.md) with announcements. Once a resource is deleted, the connected announcement will also be automatically deleted.&#x20;

***

### Frequently Asked Questions

<details>

<summary>How to create an Announcement</summary>

To create an announcement, follow the following steps.&#x20;

1. In the menu click announcements
2. Click `Create announcement`
3. Selec the [announcement type](#announcement-types) you wish to add
4. Fill in all the details.&#x20;
   1. If the announcement is connected to a resource (Amenity, Experience, or Guidebook), select the resource by clicking on the `Change` button.&#x20;
5. If the announcment has a button attached, provide all the details.&#x20;

**Hint:** *Don't forget to connect to the announcement to your preferred listings*

</details>

<details>

<summary>Why do I only see 10 announcement in the guest app? </summary>

Announcements are a powerful way to display important information to guests. In order to not have it lose it's power, we decided to not have an overkill for the guests. Therefore, we allow a maximum of 10 announcements to be displayed on the home page.\
\
However, if the guest has dismissed an announcement and there were more than 10 announcements available, upon a refresh, a new announcement will be shown.&#x20;

</details>

<details>

<summary> Can I change the sortorder of the announcements? </summary>

Definitely! We understand the importance of having the correct info at a glance.  At the listing level, you can adjust the order of the announcements.&#x20;

See [Listing Announcements](/the-basics/listings/announcements.md)

</details>


---

# Agent Instructions: 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:

```
GET https://support.holidayhero.com/the-basics/announcements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.