# Settings

## Information Showing

Use the following settings to enable or disable specific options for clients in the B2CORE UI:

**History IDs**

If `Enabled`, clients can view identifiers of deals in their trading history in the B2CORE UI.

***

**Profile IDs**

If `Enabled`, clients can view identifiers assigned to their profiles in the B2CORE UI.

***

**Change a nickname**

If `Enabled`, clients can add and change their nicknames in the B2CORE UI.

***

**Change a userpic**

If `Enabled`, clients can add and change their profile pictures in the B2CORE UI.

If you want requests to be created for adding or changing profile pictures, select `Yes` for the **Request required for avatar** option in [Client Settings](#client-settings). In this case, profile pictures are updated only after these requests are approved by the admin.

***

**Show email**

If `Enabled`, email addresses used by clients for signing-in are displayed in client profiles in the B2CORE UI.

***

**Show nickname**

If `Enabled`, the **Nickname** field is displayed in client profiles in the B2CORE UI. Nicknames are required only for clients when using the [B2COPY investment platform](https://docs.b2copy.b2broker.com/). Client nicknames are displayed in the Leaderboard, allowing easy identification and distinction between accounts.

## User Confirmation Settings

Use these options to limit the number of client attempts to confirm various actions in the B2CORE UI, such as sign-ins and others.

**Amount of Tries**

Specify the maximum number of confirmation attempts. The default limit is set to 5, meaning that after 5 unsuccessful attempts, new confirmation attempts are blocked for a client for a period specified in the **Client Confirmation Block Time** option.

***

**Client Confirmation Block Time**

Specify the period, in minutes, during which new confirmation attempts will be unavailable for a client after reaching the **Amount of Tries** limit. The default period is 10 minutes.

***

**Client Confirmation Failed Interval**

Specify the period, in minutes, after which the last failed attempt is no longer counted towards the **Amount of Tries** limit. This option resets the count of failed attempts over the specified period.

***

**Confirmation Try Limit**

Specify the maximum number of attempts for sending confirmations with 2FA codes received via emails, SMS, or Google Authenticator. The default limit is set to 5.

## User Auth Settings

Use these options to limit the number of client attempts to sign in to the B2CORE UI or change their passwords.

**Sign in Tries Before Blocking**

Specify the maximum number of client attempts to sign in to the B2CORE UI or change their password. The default limit is set to 5, meaning that after 5 unsuccessful attempts, a client is blocked for a period specified in the **Client Block Time** option.

***

**Client Block Time**

Specify the period, in minutes, during which new attempts will be unavailable for a client after reaching the **Sign in Tries Before Blocking** limit. The default period is 10 minutes.

***

**Client Auth Failed Interval**

Specify the period, in minutes, after which the last failed attempt is no longer counted towards the **Sign in Tries Before Blocking** limit. This option resets the count of failed attempts over the specified period.

## Client Settings

**Unique phone**

If `Enabled`, new clients must specify unique phone numbers during registration (if your registration procedure requires phone numbers) and can’t register with a phone number that has already been used by another client.

***

**Request required for avatar**

* If `Yes`, requests are created when clients adding or changing their profile pictures in the B2CORE UI. In this case, profile pictures are updated only after these requests are approved by the admin.
* If `No`, client can add or change their profile pictures without admin approval.

Both options relate to the **Change a userpic** option in [Information Showing](#information-showing). If **Change a userpic** is disabled, clients are not allowed to add or change their profile pictures.

## Client profile

**Address updating**

Indicates whether clients can change their country and address in the **Profile** menu of the B2CORE UI.

{% hint style="info" %}
Address updating is available only for `individual` clients and applies only to **Residential** addresses.
{% endhint %}

* **Disabled** — clients aren't allowed to change their country and address.
* **KYC validation** — clients can change their country and address but are informed that their current verification level will be reset. They must complete the KYC procedure again and submit the required documents confirming the new address to restore their level. Select this option if your KYC procedure includes address verification.
* **Request validation** — clients can change their country and address and must upload documents confirming the change. The **Address** request is then created and must be reviewed and approved by the admin in **Clients** > **Requests** in the Back Office. Select this option when your KYC procedure doesn't include address verification.

***

## Weblate

**Project ID**

Specify the identifier of a B2TRANSLATE project (formerly WEBLATE) used for maintaining translations to the supported languages in the B2CORE UI.

For more information about B2TRANSLATE, refer to the [product documentation](https://docs.b2translate.b2broker.com/).

## Exchange

**Quote lifetime (minutes)**

Specify the interval, in minutes, during which the received quote rates are valid for making exchanges in the B2CORE UI.

## Rates

**Rates Expiration (minutes)**

Specify the interval, in minutes, during which the rates for symbol pairs are displayed as valid in the B2CORE UI.

## Slack Bot

**Bot token**

Specify a token for managing your Slack bot (for details, refer to [How to set up a Slack bot](/how-to-articles/manage-communication-platforms/how-to-set-up-a-slack-bot.md)).

## Telegram Bot

**Bot API Token**

Specify a token for managing your Telegram bot (for details, refer to [How to set up a Telegram bot](/how-to-articles/manage-communication-platforms/how-to-set-up-a-telegram-bot.md)).

## Bonuses

Use the following options to configure the automatic process of crediting bonuses to clients for making deposits to their trading accounts. Bonuses are supported for trading accounts opened on MetaTrader 4/5 and cTrader.

**Autocreate from deposit**

* If `Enabled`, bonuses are automatically credited to clients once they deposit funds to their trading accounts (for details, refer to [How to automatically credit bonuses to clients upon deposits](/how-to-articles/manage-bonuses/how-to-automatically-credit-bonuses-to-clients-upon-deposits.md)).

  To enable automatic bonus crediting upon deposits, create a bonus preset for each platform where this feature is needed. The preset with the **lowest** index on a given platform will be used for automatic bonus crediting (for details, refer to [How to create a bonus preset](/how-to-articles/manage-bonuses/how-to-create-a-bonus-preset.md)).
* If `Disabled`, automatic bonuses for making deposits to trading accounts aren’t credited.

***

**Autocreated bonus percent**

The percentage of a deposit amount, which is credited as a bonus to a client trading account.

***

**Auto Bonus Limit**

The maximum bonus amount that can be automatically credited to a client trading account for making a deposit. If a calculated bonus amount exceeds the specified limit, only the maximum allowed amount is credited to the account.

***

**Auto Bonus Minimum**

The minimum amount that a client must deposit to their trading account to trigger automatic bonus crediting. This amount applies to each deposit and transfer operation made to the account, and it doesn’t relate to an overall sum of deposits made by a client.

***

**Enable "Burn if Equity < Credit"**\
\&#xNAN;*Applicable for MT4/5 only*

Select the platforms on which you want to enable this option. This option can be enabled for MT4/5 and isn't supported for cTrader.

On the selected platforms, a bonus credited to a client trading account is burnt if the account equity falls below the credited bonus amount.

***

**Burn on withdrawal**

* If `Enabled`, when a client makes a withdrawal from their trading account, a bonus credited to that account is burnt.
* If `Disabled`, withdrawals don’t affect the credited bonus.

## Two-factor authentication

**Enabled Two-factor auth providers**

Select the 2FA methods that will be visible and available for clients to use in the B2CORE UI. You can enable both Google Authenticator and SMS confirmation, or only one of them.

**Service name**

Enter the name to be displayed in the Google Authenticator app, representing the B2CORE UI for which 2FA codes are generated.

## Mobile

The options in this section are applicable if you have the mobile app deployed (for details, refer to [B2CORE Mobile](https://github.com/b2broker-gitbook/gitbook-b2core/blob/master/b2core-mobile/README.md)).

Clients can sign in to the B2CORE UI by scanning QR codes displayed on the **Sign In** page using the mobile app to which they have already been signed in. This allows them to sign in without re-entering their credentials.

**QR-code lifetime, min**

* To limit the QR code lifetime, specify the number of minutes a QR code is valid. The default limit is set to 2 minutes.
* To hide QR codes from the **Sign In** page, specify **0** or leave this field empty.

***

**Mobile application**

Select the platforms for which you want to display the button for downloading the mobile app. The button will appear on the **Sign In** page of the B2CORE UI and at the top of the **Dashboard** after clients sign in (for details, refer to [How to configure settings for mobile app downloads](/how-to-articles/manage-system-settings/how-to-configure-settings-for-mobile-app-downloads.md)). — By default, this field is empty. Possible options:

* **iOS** — select this option to provide a link for downloading your iOS app from the Apple Store.
* **Android** — select this option to provide a link for downloading your Android app from Google Play.
* **Android APK Registry** — select this option to provide a link for downloading the Android APK.

***

**iOS URL**

If you selected **iOS**, specify the URL for downloading the iOS app from the Apple Store.

***

**Android URL**

If you selected **Android**, specify the URL for downloading the Android app from Google Play.

***

**Android APK Registry ID**

If you selected **Android APK Registry**, specify the universally unique identifier (UUID) of the Android APK. This UUID is used to generate the download link for the Android APK.

***

## Metatrader 4 and Metatrader 5

**Partner program enabled**

If `Enabled`, IB programs are available on the respective platforms.

## Other settings

**Confirmation phone code lifetime**

Specify the period, in seconds, during which a verification code sent to a client phone number is valid.

***

**Sms limit for each recipient**

Specify the maximum number of verification code messages that can be requested by a client per day.

***

**User-admin session between 1 – 120 (min)**

Specify the session time limit for [Back Office users](/back-office-guide/system/users.md), in minutes. The default limit is set to 24 minutes. After reaching a specified time limit, users are automatically signed out of the Back Office.


---

# 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/back-office-guide/system/settings.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.
