# How to add custom menu items

You can add custom items to the menu displayed in both the B2CORE UI and mobile app.

In the mobile apps, these items appear in the **Services** section. This functionality is supported starting from **iOS** v1.29 and **Android** v2.6.0.

{% hint style="info" %}
To be able to add custom menu items, you should be granted the `Update menu` permission (for details, refer [How to add a user group and grant permissions](https://docs.b2core.b2broker.com/how-to-articles/manage-system-settings/how-to-add-a-user-group-and-grant-permissions)).
{% endhint %}

To add a custom menu item:

{% stepper %}
{% step %}
Navigate to **Promotion** > **Menu**.
{% endstep %}

{% step %}
To view a list of available menu items, click the **eye** icon located in the **General** row.

{% hint style="info" %}
Custom menu items can be added under the **General** menu tree or within any existing menu item. To navigate inside an existing item, click the eye **icon** in the respective row.
{% endhint %}
{% endstep %}

{% step %}
Click **+Create** in the upper-right page corner.
{% endstep %}

{% step %}
In the displayed popup, fill in the following required fields:

* In the **Name** field, enter a unique name for the menu item.
* On the **Caption** field, enter a caption for the menu item that will be displayed to clients in the B2CORE UI menu or the **Services** section of the mobile app.
* In the **External URL** field, specify the URL to an external resource or web page to which clients will be redirected when they click the menu item.
* In the **Icon** field, specify the URL of an image that will be used as the menu icon in the B2CORE UI.

  The image must meet the following requirements:

  * **Format**: SVG
  * **Size**: 16×16 pixels
  * **Style**: monochrome (single color, typically black or white: #000000/ #FFFFFF)
  * **Background**: transparent (recommended)
    {% endstep %}

{% step %}
Optionally, apply restrictions to the menu item:

* To make the menu item available only to clients with specific verification levels, select the appropriate levels in the **Verification Level Allowance** dropdown.
* To make a menu item available only to clients that are assigned specific types, select the corresponding types in the **Client Type Allowance** dropdown.

If no options are selected in these dropdowns, the menu item will be available to all clients without any restrictions.
{% endstep %}

{% step %}
To mark the menu item as "New" in the B2CORE UI, enable the **New** checkbox.
{% endstep %}

{% step %}
To mark the menu item visible in the B2CORE UI and mobile app, enable the **Visible** checkbox; otherwise, it will be hidden.
{% endstep %}

{% step %}
Click **Save** to add the custom menu item.
{% endstep %}
{% endstepper %}

The custom menu item will appear in the menu tree. To adjust its position, simply drag and drop it to the desired location.

If needed, specify the localization properties for the item caption by clicking the button located on the right side of its caption in the **Caption** field.


---

# 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.b2core.b2broker.com/how-to-articles/manage-advertising-options/how-to-add-custom-menu-items.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.