> For the complete documentation index, see [llms.txt](https://support.holidayhero.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.holidayhero.com/the-basics/announcements.md).

# 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>