> For the complete documentation index, see [llms.txt](https://documentation.madonnestudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.madonnestudio.com/free-scripts/madonne-notify/common-errors.md).

# Common Errors

## 🔴 Notifications are not showing up

**Cause 1:** `MS_Madonne_Notify` is not started on your server.

**Fix:** Make sure the resource is added to your `server.cfg` and started before any resource that depends on it:

```cfg
ensure MS_Madonne_Notify
```

**Cause 2:** The resource started but the NUI page failed to load.

**Fix:** Check your server console for any errors related to `MS_Madonne_Notify`. Make sure the `ui/` folder is present and intact in the resource directory.

***

## 🔴 Export call throws an error

**Cause:** The resource name in the export call doesn't match the actual folder name.

**Fix:** Make sure you are using the exact resource name. The correct call is:

```lua
exports['MS_Madonne_Notify']:Notify(...)
```

Double-check that the folder is named `MS_Madonne_Notify` (case-sensitive on Linux servers).

***

## 🔴 Server-side export doesn't send the notification to the player

**Cause:** The `target` parameter is incorrect or the player is no longer connected.

**Fix:** Make sure you are passing a valid active server ID. Use `source` inside a server event handler, or verify the player is still online before triggering.

```lua
-- Correct server-side usage
exports['MS_Madonne_Notify']:Notify(source, "info", "Title", "Message", 5000, false)
```

***

## 🔴 The notification appears but no sound plays

**Cause:** The `sound` parameter is set to `false` or omitted.

**Fix:** Pass `true` as the last parameter:

```lua
exports['MS_Madonne_Notify']:Notify("success", "Title", "Message", 5000, true)
```

***

## 🔴 You lack the required entitlement to use MS\_Madonne\_Notify

This message indicates that your server does not have the necessary entitlement to start the resource. This is related to FiveM's **Escrow** protection system.

Check the following points one by one:

* ✅ The **CFX Portal key** listed in your `server.cfg` does not contain any typing error
* ✅ The CFX Portal key belongs to the **FiveM account that was used to purchase or claim** the resource
* ✅ The resource has been **successfully claimed** on the [CFX Portal](https://portal.cfx.re/)
* ✅ The CFX Portal key linked to your server **belongs to you**, and not to your hosting provider

> ⚠️ **Important warning about hosting provider keys**
>
> Some hosting providers include a shared CFX Portal key as part of their offers. We strongly advise against using such keys. A key that does not belong to you will block the use of **any resource protected by FiveM's Escrow system**, without exception — not just this one. Always use your own personal CFX Portal key.

***

## 💬 Still having issues?

If you are still experiencing problems after following the steps above, feel free to reach out to us:

* 💬 **Discord:** [discord.gg/madonne](https://discord.gg/madonne)
* 🌐 **Website:** [madonnestudio.com](https://madonnestudio.com/)
* 📧 **Email:** <contact@madonnestudio.com>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://documentation.madonnestudio.com/free-scripts/madonne-notify/common-errors.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.