> For the complete documentation index, see [llms.txt](https://help.johnbot.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.johnbot.app/en/faq.md).

# FAQ

### :rocket: Introduction

While using John-Bot, you may run into some common questions. This page lists the most frequently asked ones so you can find answers instantly without having to contact support.

If you can't find what you're looking for, check [the documentation](/en/readme.md), [the video tutorials](https://jnbt.xyz/tutorials), or [contact the support team](/en/contact.md).

### :question: Frequently Asked Questions

<details>

<summary>What is John-Bot?</summary>

John-Bot is a Discord bot designed to simplify the management of Discord servers. It comes packed with a wide range of useful features, including a ticketing system, a logging system, join & leave actions, an XP-based leveling system, a giveaway system, and an advanced moderation system, among others.¹

</details>

<details>

<summary>Why can't I select the role I want?</summary>

When setting up autoroles or leveling reward roles, you may notice that some roles appear grayed out, are unselectable, and are marked with a red indicator. This can be caused by one of two issues:

* **Role not accessible by John-Bot**: John-Bot doesn't have enough permissions to manage this role. To fix this, move the role named "John-Bot" (the application role) above the desired roles in your server's role hierarchy. John-Bot must also have the Administrator permission (or at the very least, "Manage Roles").
* **Role not manageable by John-Bot**: Discord prevents bots from managing certain roles. This applies to other application roles and Server Booster reward roles.

</details>

***

¹: this list is not exhaustive


---

# 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, and the optional `goal` query parameter:

```
GET https://help.johnbot.app/en/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.