> For the complete documentation index, see [llms.txt](https://mango-5m.gitbook.io/mango5m-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mango-5m.gitbook.io/mango5m-docs/i-need-support.md).

# I Need Support

How to get help with any Mango 5M resource — what to check first, where to ask, and exactly what to include.

We're happy to help — and you'll get help *fastest* when you arrive with the right information. This page covers what to check before asking, where support happens, and what a useful request looks like.

## Before requesting support

Most questions are already answered in the documentation. Before opening a support request, run through this list:

1. **Read the relevant resource documentation** — open your resource's section under one of the **Resources** groups in the sidebar (e.g. [Mango Notify](/mango5m-docs/free-resources/mango-notify.md)).
2. **Check the installation guide** — most "it doesn't work" cases are a missed install step or load-order issue.
3. **Check the configuration guide** — confirm the option you're fighting actually does what you think it does.
4. **Check the troubleshooting section** — it's matched to the exact console errors you'll see.
5. **Check whether the issue is already known** — search the Discord; someone may have hit (and solved) it already.

{% hint style="info" %}
Five minutes in the docs regularly saves a day of back-and-forth. If the documentation turned out to be wrong or unclear, tell us that too — we fix docs like we fix bugs.
{% endhint %}

## Join the Mango 5M Discord

Support for every Mango 5M resource happens in the **official Mango 5M Discord**:

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>💬 Mango 5M Discord</strong></td><td>The main location for Mango 5M support and community.</td><td><a href="https://discord.gg/sZn2A543De">https://discord.gg/sZn2A543De</a></td></tr></tbody></table>

Head there for:

* Installation issues
* Configuration problems
* Bugs and errors
* Integration problems (frameworks, inventories, billing, dispatch, …)
* General questions
* Product support

## How to request support

The more you give us up front, the faster we can help. A good support request includes:

| Include                    | Why it matters                                                 |
| -------------------------- | -------------------------------------------------------------- |
| **Which resource**         | Mango MDT? Something else? Say which.                          |
| **Resource version**       | From the resource's `fxmanifest.lua`.                          |
| **Framework**              | ESX Legacy, QBCore, or Qbox — and any relevant forks.          |
| **Server artifacts/build** | When the issue smells runtime-related.                         |
| **The full error**         | The complete console error — not a fragment, not a paraphrase. |
| **Expected vs actual**     | What you expected to happen, and what actually happened.       |
| **Steps to reproduce**     | What you did, in order, so we can make it happen too.          |
| **Relevant configuration** | The config section involved (with any secrets removed).        |

{% hint style="warning" %}
**"It doesn't work" is not a bug report.** Screenshots, console logs, and full error messages are worth more than any description — paste them. If we can reproduce it, we can usually fix it.
{% endhint %}

## Bug reports

Found a genuine bug? Report it through the Mango 5M Discord's support channel. A useful bug report includes:

* Resource name and **version**
* A clear **description** of the issue
* **Steps to reproduce**
* **Expected** behaviour
* **Actual** behaviour
* **Console errors** (full text)
* Client/server **logs** where relevant

Confirmed bugs get fixed — good reports genuinely shape the next release.

## Support rules

A few ground rules keep support fast and pleasant for everyone:

* **Don't DM developers** for support unless specifically asked to — support happens in the official channels, where the whole team can help.
* **Don't repeatedly ping staff.** We've seen your message; pinging again doesn't move it up the queue.
* **Don't send incomplete error messages** — the last line of an error is rarely the useful part.
* **Don't ask for help without the relevant information** — see the table above.
* **Be respectful** to the support team and the community.
* Support is provided through the **official Mango 5M Discord** — not marketplace comments or DMs.

## The support flow

{% stepper %}
{% step %}

### Read the documentation

Check whether your issue is already covered — the troubleshooting sections are written from real support cases.
{% endstep %}

{% step %}

### Check your installation and configuration

Confirm the resource is installed per its guide, dependencies are started **before** it, and the config matches your setup.
{% endstep %}

{% step %}

### Join the Discord

<https://discord.gg/sZn2A543De> — the official Mango 5M Discord, where all support happens.
{% endstep %}

{% step %}

### Provide useful information

Resource, version, framework, full errors, logs, steps to reproduce — everything from the table above.
{% endstep %}

{% step %}

### Wait for assistance

We'll get to you as quickly as we can. Please don't re-send your message or ping staff while you wait.
{% endstep %}
{% endstepper %}