> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/~/revisions/cIYk4huBoAvhOouMPj2d/mobile-app/adding-and-managing-bots.md).

# Adding and Managing Bots

### Adding a Bot on Mobile <a href="#adding-a-bot-on-mobile" id="adding-a-bot-on-mobile"></a>

#### Step 1: Access the Add Bot Menu <a href="#step-1-access-the-add-bot-menu" id="step-1-access-the-add-bot-menu"></a>

1. Log into the mobile app
2. You’ll get to the landing page
3. Locate the **"Add"** button in the top right corner
4. Tap the button

<div align="left"><figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2FOQ9ohkFxXPugTugSdIEL%2FIMG_7146%20(1).jpg?alt=media&amp;token=f7cf2cce-c52a-4ebe-9721-0229938175ed" alt="" width="188"><figcaption></figcaption></figure></div>

***

#### Step 2: Browse Available Bots <a href="#step-2-browse-available-bots" id="step-2-browse-available-bots"></a>

When you tap "Add" a window will appear displaying all bots available to you.

<div align="left"><figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2FQ2ImTOZRxJaik7pphbP8%2FIMG_7141%20(1).PNG?alt=media&amp;token=607ffd7b-933e-4cc1-b24b-20ffcc531b0e" alt="" width="188"><figcaption></figcaption></figure></div>

***

#### Step 3: Filter Bots (Optional) <a href="#step-3-filter-bots-optional" id="step-3-filter-bots-optional"></a>

You can narrow down your bot selection using several filters:

**Filter by Accessibility:**

* **All Types** — Shows all bots regardless of when they were created
* **Private** — Bots restricted to specific users
* **Restricted** — Bots with limited access permissions
* **Public -** Bots available to all users on the instance

**Filter by Category:**

* Bots are organized by categories (e.g., HR, Sales, Support, etc.)
* Categories help you find bots relevant to your department or task

<div align="left"><figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2FemWhPImAZ24Vh95ydKsa%2FIMG_7149%20(1).jpg?alt=media&amp;token=45fedb2b-eb97-4fa2-93e5-18fd34bb4a7e" alt="" width="188"><figcaption></figcaption></figure></div>

***

#### Step 4: Select and Add a Bot <a href="#step-4-select-and-add-a-bot" id="step-4-select-and-add-a-bot"></a>

1. Browse or filter to find your desired bot
2. Tap on the “Add” button to add the bot

<div align="left"><figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2FWW26R6vK1dvmnJoUYMS6%2FIMG_7148%20(1).jpg?alt=media&amp;token=c5b1671e-4c43-41ec-832b-f569029e033d" alt="" width="188"><figcaption></figcaption></figure></div>

3. The bot will now appear in your bot list on mobile

***

### Creating New Bots (Desktop Only) <a href="#creating-new-bots-desktop-only" id="creating-new-bots-desktop-only"></a>

**⚠️ Important:** While you can **add existing bots** on mobile, you **cannot create new bots** from the mobile app. New bot creation must be done on desktop.

To create a new bot:

1. Log into the platform on desktop
2. Use the **Bot Creator** tool for team-wide bots → not available to the “User” role
3. Once created, the bot will be available to add on both desktop and mobile

<div align="left"><figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2F49nOQ1JGi2ykMtUZmhG2%2FScreenshot%202026-04-23%20at%2014.02.41.png?alt=media&amp;token=f4a8201d-05ff-411d-b43b-96212f69f9f7" alt="" width="375"><figcaption></figcaption></figure></div>

***

### Filtering Bots on Mobile <a href="#filtering-bots-on-mobile" id="filtering-bots-on-mobile"></a>

You can **filter and organize your added bots** for easier access.

#### How to Filter Bots <a href="#how-to-filter-bots" id="how-to-filter-bots"></a>

1. Locate the **filter icon** on the right side of the screen
2. Tap the icon to open filter options

<div align="left"><figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2Fs9qZmROQaGJiW9bNkwde%2FIMG_7146%20(2).jpg?alt=media&amp;token=9a6cd48c-3a3d-4fee-8c35-2270c0b2ab21" alt="" width="188"><figcaption></figcaption></figure></div>

3. Choose your preferred filter:

**Available Filter Options:**

| Filter Type       | Description                                         |
| ----------------- | --------------------------------------------------- |
| **Last Used**     | Shows bots you've recently interacted with          |
| **Name (A to Z)** | Alphabetical order, ascending                       |
| **Name (Z to A)** | Alphabetical order, descending                      |
| **Category**      | Filter by bot category (same categories as desktop) |
| **Accessibility** | Filter by private, restricted, or all-time bots     |

<div align="left"><figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2FKINsfIWyKMt9puFsIGHS%2FIMG_7150%20(1).jpg?alt=media&amp;token=df833602-3e35-4c4a-ae39-2b5a4139939d" alt="" width="188"><figcaption></figcaption></figure></div>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.blockbrain.ai/~/revisions/cIYk4huBoAvhOouMPj2d/mobile-app/adding-and-managing-bots.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
