# Notifications

Our notification system allows you to send notifications directly to user’s computers. This can be useful for displaying general information or important issues.

## User Experience

Once you have created your notification, the target groups will receive a notification at the scheduled time. This notification appears on the desktop of a client.

The user receives different colored notifications based off the notification category chosen. Once a notification has been closed and acknowledged by the user, it will not re-appear.

<div><figure><img src="/files/BNyJlSyk66MVM6rk5TJi" alt=""><figcaption><p>Category: None</p></figcaption></figure> <figure><img src="/files/fLkcHsviXPK2v60WtL03" alt=""><figcaption><p>Category: Info</p></figcaption></figure> <figure><img src="/files/3dMkDmt8TUWtpAkIicLM" alt=""><figcaption><p>Category: Alert</p></figcaption></figure></div>

The notifications are transparent and are able to be clicked through to minimize disruption. This can be changed in the [Advanced Settings](#advanced-settings).

## Creating a Notification

### Basic Settings

1. **Category**: Choose the category of your notification. The options are:
   * None
   * Info
   * Alert
2. **Notification Schedule**: Set a Start and End date for the notification. The notification will only be active during this period. Use the prompts to quickly fill
3. **Target Groups**: Specify which [groups](/ugd-management/user-list.md) should receive the alert. You can also exclude certain groups if needed.
4. **Notification Content**: This includes:
   * **Language (Optional)**: Additional language versions of your notification. This field accepts IETF language tags and the language is evaluated by the current Windows language by the agent. The default and fallback is always *en.*
   * **Title**: The headline of your notification.
   * **Body**: The main content of your notification.

<figure><img src="/files/kqtXZqak8vGjVs06LKWR" alt=""><figcaption></figcaption></figure>

### Advanced Settings

1. **Disable Click Through**: If enabled, users will not be able to click on the notification to navigate to a different page.
2. **Disable Transparency**: If enabled, the notification window will not be transparent.

<figure><img src="/files/n8cyQ97mWGmjNLhES8Qq" alt=""><figcaption></figcaption></figure>

Please note that these advanced options might affect the user experience, so use them wisely.

Effective notifications are concise, relevant, and timely. Always respect the user’s time and attention when sending notifications.

### Saving and Publishing Notifications

In order to publish a notification, the configured notification must first be saved as a draft.

<figure><img src="/files/CxxbSNkpjZag1dK7M5qQ" alt=""><figcaption></figcaption></figure>

Drafts will appear in the notification list with a yellow "Draft" tag.

<figure><img src="/files/f6nfRVoZov5oPE5X5IhO" alt=""><figcaption></figcaption></figure>

Once a draft has been saved, the administrator will be prompted to either Publish or Delete.

<figure><img src="/files/JaytNhThVvIEfvAumFIb" alt=""><figcaption></figcaption></figure>

* **Publish:** Selecting Publish will prompt for an additional Confirm Publish button.\
  ![](/files/q7u0gNp2gr2zoGDisL4Q)\
  Once notifications are sent out, they are not easily retrieved. Please make sure the notification is configured as intended prior to publishing.
* **Delete:** Selecting Delete will prompt for an additional Confirm Delete button.\
  ![](/files/zpaeFeSKd08MrwqCF3Ni)\
  Once messages are deleted, they cannot be recovered. They will be deleted after 30 days.

### Cancelling a Notification

Once a notification has been published, administrators will have the option to cancel the notification.

<figure><img src="/files/okKDBWgKWCXVwwFc0ctN" alt=""><figcaption></figcaption></figure>

Cancelling a notification will cause the notification to disappear from a user's device without their intervention. Cancelled notifications cannot be recovered, will be deleted after 30 days and appear in the notification list with a red "Cancelled" tag.

<figure><img src="/files/5dUnQC3MxcSkzX4GqjWI" alt=""><figcaption></figcaption></figure>


---

# 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://docs.realmjoin.com/realmjoin-agent/realmjoin-client/showing-notifications.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.