> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/technical-guides/mcp-server/mcp-label-settings-by-role.md).

# MCP - Label settings by role

This page lists the settings of the **Label settings** screen in the Back-Office (and of a brand's settings), with what each client role can read and change. The role is the permission group of your Back-Office user (**CRM Admin**, **CRM Manager** or **CRM Manager + Engineer**). The [MCP Server](https://help.smartico.ai/welcome/technical-guides/mcp-server) works on exactly these settings, with the same rights: it acts as the Back-Office user of the token. To change a setting that your role cannot change, ask your Smartico success manager.

## How to read the table

* **Read**: the role sees the setting and its value.
* **Read + change**: the role can also change the value.
* **—**: the role does not see the setting.
* **Admins only** (Smartico staff column): only Smartico administrators can change the setting.
* The **Key** column gives the name of the setting for the MCP. Use it to search settings and to change one: see [MCP - label and brand settings](https://help.smartico.ai/welcome/technical-guides/mcp-server/mcp-label-and-brand-settings.md).
* **Hidden** settings hold a credential, such as a webhook URL or a server key. Through the MCP their value is never shown and they cannot be changed, even when your role can change them on the screen.
* Some settings show only when a switch on the same screen is on (a few: when it is off). For example, the level logic settings need **Level logic: points + behavior counters**, and the clan settings need **Clans**. The MCP lists such a setting while the switch hides it too: read-only, with `hidden_until` naming the switch. It can be changed through the MCP once the switch is turned. A setting your account cannot have (another account type, or a product your account does not have and no switch on the screen turns on) is not listed and cannot be read or changed through the MCP.
* Settings that only Smartico staff can see are not listed. Neither are the account fields of the screen that are not label settings (such as the label name, the icon and the products switches): the MCP can read them but does not change them.

## System settings

### General

| Setting                                                 | Key                                        | What it does                                                                                 | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ------------------------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Time zone for date/time hints in the BackOffice         | `BO_TIMEZONE_FOR_UI_SIDE_CONVERSION`       | Time zone of the time hints on Back Office forms.                                            | Read + change | Read        | Read                   | Read + change  |
| Allow time zones with daylight saving time in schedules | `ENABLE_DST_IN_SCHEDULERS`                 | Adds a time zone choice to schedules of campaigns, rules, missions, tournaments and raffles. | Read          | Read        | Read                   | Read + change  |
| Block saving a label tag that uses unknown tags         | `ERROR_ON_LABEL_TAG_CREATION_IF_NOT_EXIST` | Refuses to save a label tag that uses tags that do not exist.                                | Read + change | Read        | Read                   | Read + change  |

### Additional features

| Setting                                                    | Key                            | What it does                                               | CRM Admin | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ---------------------------------------------------------- | ------------------------------ | ---------------------------------------------------------- | --------- | ----------- | ---------------------- | -------------- |
| Recommended bet amounts: rounding rules (casino and sport) | `RECOM_CAS_BET_ROUNDING_RULES` | Allowed amounts for the recommended bet, per currency.     | Read      | Read        | Read                   | Read + change  |
| Recommended deposit amount: rounding rules                 | `RECOM_DEPOSIT_ROUNDING_RULES` | Allowed amounts for the recommended deposit, per currency. | Read      | Read        | Read                   | Read + change  |

### AI & Statistical models

| Setting                                       | Key                                   | What it does                                                                   | CRM Admin     | CRM Manager   | CRM Manager + Engineer | Smartico staff |
| --------------------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------ | ------------- | ------------- | ---------------------- | -------------- |
| Best time models: maximum number              | `BCT_MODELS_LIMIT`                    | How many Best time models the label can have.                                  | Read          | Read          | Read                   | Read + change  |
| AI tokens per month (all AI tools)            | `AI_CHAT2_TOKENS_PER_LABEL_PER_MONTH` | Monthly AI token budget shared by AI agents, Vibe Studio and MCP data queries. | Read          | Read          | Read                   | Read + change  |
| Vibe Studio: brand rules for the AI assistant | `WEB_STUDIO_LABEL_SPECIFIC_PROMPT`    | Your brand rules for the Vibe Studio AI assistant.                             | Read + change | Read + change | Read + change          | Read + change  |

### Insights

| Setting                                      | Key                                                | What it does                                                            | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| -------------------------------------------- | -------------------------------------------------- | ----------------------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Alert before a big scheduled campaign starts | `INSIGHTS_ALERT_BEFORE_BIG_CAMPAIGN_START_ENABLED` | Insights alerts up to 1 hour before a big scheduled campaign starts.    | Read + change | Read        | Read                   | Read + change  |
| Big campaign alert: audience share, %        | `INSIGHTS_ALERT_BEFORE_BIG_CAMPAIGN_START`         | Share of all players that makes a scheduled campaign "big".             | Read + change | Read        | Read                   | Read + change  |
| DWH usage alert: monthly limit, TB           | `DWH_MONTHLY_USAGE_SOFT_ALERT_TB`                  | Insights alerts when data warehouse use this month passes this many TB. | Read + change | Read        | Read                   | Read + change  |

### Content management

| Setting                                      | Key                                 | What it does                                         | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| -------------------------------------------- | ----------------------------------- | ---------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Content languages in the BackOffice          | `LANGUAGES`                         | Languages you can add to content in the Back Office. | Read + change | Read        | Read                   | Read + change  |
| Properties for content variations            | `RESOURCE_VARIATION_CJM_PROPERTIES` | Properties you can use for content variations.       | Read          | Read        | Read                   | Read + change  |
| Compress uploaded images and convert to WebP | `IMAGE_RESOURCES_CONVERT_TO_WEBP`   | Compresses uploaded images and saves them as WebP.   | Read          | Read        | Read                   | Read + change  |

### Bonuses

| Setting                                               | Key                                       | What it does                                                               | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ----------------------------------------------------- | ----------------------------------------- | -------------------------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Max bonuses per test player per day                   | `BONUS_TEST_USER_CAP_COUNT`               | Highest number of bonuses one test player can get per day.                 | Read + change | Read        | Read                   | Read + change  |
| Max bonuses per player per day                        | `BONUS_CAP_COUNT`                         | Highest number of bonuses one real player can get per day.                 | Read + change | Read        | Read                   | Read + change  |
| Max total bonus cost per player per day               | `BONUS_CAP_AMOUNT`                        | Highest total bonus cost one player can get per day.                       | Read          | Read        | Read                   | Read + change  |
| Give bonuses to non-active players                    | `BONUS_CHECK_ACCOUNT_STATUS`              | Gives bonuses whatever the player account status is.                       | Read + change | Read        | Read                   | Read + change  |
| Send bonuses to the platform in batches               | `BONUS_BATCH_PROCESS`                     | Sends bonuses to your platform in batches instead of one by one.           | Read          | Read        | Read                   | Read + change  |
| Retry bonuses rejected by the platform                | `RETRY_BONUS_ENABLED`                     | Sends a bonus that your platform rejected again for a while.               | Read          | Read        | Read                   | Read + change  |
| Dynamic rewards: min wait before calculation, seconds | `BONUS_ENGINE_SEC_MIN_TIME_IN_WAIT`       | How long a dynamic reward request waits before it is calculated.           | Read          | Read        | Read                   | Read + change  |
| Dynamic rewards: batch wait time, seconds             | `BONUS_ENGINE_SEC_MAX_TIME_IN_WAIT`       | How often dynamic rewards are calculated.                                  | Read          | Read        | Read                   | Read + change  |
| Dynamic rewards: max calculation period, days         | `BONUS_ENGINE_MAX_TIME_WINDOW_DAYS`       | Longest period of transactions a dynamic reward formula can use.           | Read          | Read        | Read                   | Read + change  |
| Dynamic rewards: send "skipped" event                 | `BONUS_ENGINE_TRIGGER_SKIP_EVENT`         | Sends an event when a dynamic reward is not given.                         | Read          | Read        | Read                   | Read + change  |
| Default bonus expiration, days                        | `_system_bonus_expiration_days`           | Days until an unclaimed bonus expires, when the template sets none.        | Read          | Read        | Read                   | Read + change  |
| Block bonus redemption in the widget                  | `_system_block_bonus_redeem`              | Players cannot claim bonuses in the widget.                                | Read          | Read        | Read                   | Read + change  |
| Hide bonuses in the gamification widget               | `_system_block_bonuses`                   | Players see no bonuses in the widget.                                      | Read          | Read        | Read                   | Read + change  |
| Refund points when a store bonus fails                | `rtg_return_points_if_fail_to_redeem`     | Gives the points back when a store bonus fails.                            | Read          | Read        | Read                   | Admins only    |
| Exclude failed bonuses from store purchase limits     | `EXCLUDE_FAILED_BONUSES_FROM_STORE_LIMIT` | Store purchases whose bonus failed do not count toward the purchase limit. | Read + change | Read        | Read                   | Read + change  |

### Integration

| Setting                                                                 | Key                                     | What it does                                                                    | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ----------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Property for public name of user                                        | `PUBLIC_USERNAME_PROPERTY_NAME`         | Properties used as the player's public name.                                    | Read          | Read        | Read                   | Read + change  |
| Hide other players' external IDs in tournaments                         | `SECURITY_MASK_EXT_USER_IDS`            | The widget does not get other players' external IDs in tournament leaderboards. | Read + change | Read        | Read                   | Read + change  |
| Calculate total values on the Smartico side                             | `LABEL_CALCULATE_AGGREGATED_PROPERTIES` | Smartico updates total properties (such as total deposits) from events.         | Read          | Read        | Read                   | Read + change  |
| Encrypt player email and phone                                          | `LABEL_ENCRYPT_PII`                     | Stores player email and phone only in encrypted form.                           | Read          | Read        | Read                   | Read + change  |
| Allow `{{state.user_email}}` in the content                             | `LABEL_DECRYPT_PII_MAIL`                | The email tag in mail content gives the real address.                           | Read          | Read        | Read                   | Read + change  |
| Allow `{{state.user_email}}` and `{{state.user_phone}}` in the WebHooks | `LABEL_DECRYPT_PII_WEBHOOK`             | The email and phone tags in webhooks give the real values.                      | Read          | Read        | Read                   | Read + change  |
| Default player currency                                                 | `LABEL_DEFAULT_PLAYER_CURRENCY_FOR_KPI` | Currency used for a player whose currency is not known.                         | Read          | Read        | Read                   | Read + change  |
| Reject money events from players without currency                       | `CJM_SKIP_EVENT_WITHOUT_CURRENCY`       | Rejects money events of players who have no wallet currency.                    | Read          | Read        | Read                   | Read + change  |
| Bet-win stitching: wait for win, seconds                                | `BET_WIN_TRANSACTION_DELAY`             | How long Smartico waits for the win of a casino bet before it joins them.       | Read          | Read        | Read                   | Read + change  |
| Webhook request timeout, seconds                                        | `WEBHOOK_REQUEST_TIMEOUT`               | How long a webhook call from campaigns and rules waits for a reply.             | Read + change | Read        | Read                   | Read + change  |
| Game session end after inactivity, seconds                              | `GAMEPLAY_SESSION_STATS_EXPIRATION`     | Seconds after the last bet when a game session counts as ended.                 | Read          | Read        | Read                   | Read + change  |
| Ignore old events in campaigns and gamification, hours                  | `CJM_SKIP_EVENT_AGE_HOURS`              | Events older than this do not start campaigns, rules or gamification.           | Read          | Read        | Read                   | Read + change  |

### Front-end

| Setting                                         | Key                                      | What it does                                                                | CRM Admin     | CRM Manager   | CRM Manager + Engineer | Smartico staff |
| ----------------------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------- | ------------- | ------------- | ---------------------- | -------------- |
| Require a signed hash to identify players       | `USER_IDENTIFY_ENABLE_HASH_CHECK`        | Accepts a player ID from your site only with a valid hash.                  | Read          | Read          | Read + change          | Read + change  |
| Languages allowed on the front-end              | `FRONT_END_ALLOWED_LANGUAGES`            | Languages the widget, popups and inbox may use.                             | Read + change | Read          | Read                   | Read + change  |
| Don't show popups and inbox messages on pages   | `FRONT_DISABLE_POPUP_INBOX_ON_URLS`      | Pages where new popups and inbox messages are not shown.                    | Read + change | Read          | Read + change          | Read + change  |
| Don't show inbox notifications on pages         | `FRONT_DISABLE_INBOX_ON_URLS`            | Pages where new inbox messages do not pop up.                               | Read + change | Read          | Read + change          | Read + change  |
| Don't show forms on pages                       | `FRONT_DISABLE_FORMS_ON_URLS`            | Pages where forms are not shown.                                            | Read + change | Read          | Read + change          | Read + change  |
| Delay for online messages right after login, ms | `DELAY_ENGAGEMENT_EXECUTION_ON_LOGIN_MS` | Holds popups and other online messages for a short time after login.        | Read + change | Read          | Read                   | Read + change  |
| Pause before the next popup, ms                 | `FRONT_DELAY_BETWEEN_POPUPS_MS`          | Pause before the next popup is shown.                                       | Read + change | Read          | Read                   | Read + change  |
| Queue popups: show one popup at a time          | `FRONT_ENABLE_POPUPS_QUEUE`              | A new popup waits until the open one is closed.                             | Read + change | Read          | Read                   | Read + change  |
| Show a popup in one browser tab only            | `FRONT_SHOW_POPUP_IN_ONE_TAB_ONLY`       | Shows each popup in one browser tab only.                                   | Read + change | Read          | Read                   | Read + change  |
| Enable 'Core: page navigation' event            | `ENABLE_FRONT_PAGE_NAVIGATION_EVENT`     | The Smartico script sends an event each time the player opens a page.       | Read          | Read          | Read                   | Read + change  |
| Don't open related games by link                | `GAMIFICATION_PREVENT_GAME_OPENING`      | A click on a related game calls your site instead of opening the game link. | Read + change | Read          | Read + change          | Read + change  |
| Deep link URL of your website                   | `WEB_SITE_DP_HANDLER`                    | Page of your site that runs deep links.                                     | Read + change | Read + change | Read + change          | Read + change  |
| Custom JavaScript run by the Smartico script    | `JS_INJECTION`                           | Your own JavaScript that the Smartico script runs on each page load.        | Read + change | Read + change | Read + change          | Read + change  |
| Gamification widget: background darkness        | `GAMIFICATION_WIDGET_BG_OPACITY`         | How dark the page behind the widget is.                                     | Read          | Read          | Read                   | Admins only    |
| Popups: background darkness                     | `GAMIFICATION_POPUP_BG_OPACITY`          | How dark the page behind popups is.                                         | Read + change | Read          | Read                   | Read + change  |
| Popups: background blur, px                     | `GAMIFICATION_POPUP_BG_BLUR`             | Blur of the page behind popups.                                             | Read          | Read          | Read                   | Admins only    |
| Domains where the Smartico script may run       | `FRONT_END_ALLOW_DOMAINS`                | Domains where the Smartico script may run.                                  | Read + change | Read + change | Read + change          | Read + change  |

## Marketing automation

### Mails

| Setting                                    | Key                                   | What it does                                                                         | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ------------------------------------------ | ------------------------------------- | ------------------------------------------------------------------------------------ | ------------- | ----------- | ---------------------- | -------------- |
| Enable mails                               | `_system_send_emails`                 | Turns mail sending on or off.                                                        | Read + change | Read        | Read                   | Read + change  |
| Mail sending hours                         | `MAIL_ACTIVE_HOURS`                   | Hours when mails may be sent.                                                        | Read + change | Read        | Read                   | Read + change  |
| Mail bounce rules                          | `EMAIL_BOUNCE_STRATEGY`               | Which mail status a provider failure reason sets.                                    | Read          | Read        | Read                   | Read + change  |
| Also send mails to these mail statuses     | `SEND_ALLOWED_EMAIL_STATUSES`         | Mail statuses that also get mails, besides New and Verified.                         | Read          | Read        | Read                   | Read + change  |
| Mail 'To' line format                      | `MAIL_TO_PATTERN`                     | Format of the recipient line of a mail.                                              | Read          | Read        | Read                   | Read + change  |
| Mail unsubscribe page (mail asset ID)      | `UNSUBSCRIBE_MAIL_RESOURCE_ID`        | Your own unsubscribe page for mails.                                                 | Read          | Read        | Read                   | Read + change  |
| Send messages through Smartico Data Guard  | `ACTIVITY_THROUGH_PROXY`              | Sends mails, instant messages and IVR calls through your Smartico Data Guard server. | Read          | Read        | Read                   | Read + change  |
| Mail opt-out properties for "Send only if" | `EMAIL_CUSTOM_OPTOUT_PROPS`           | Yes/no properties offered in "Send only if" of the Mail activity.                    | Read          | Read        | Read                   | Read + change  |
| Mail device previews per month             | `MAIL_REAL_PREVIEW_CREDITS_PER_MONTH` | Mail device previews per month.                                                      | Read          | Read        | Read                   | Read + change  |
| Show the BCC field in Mail activities      | `BCC_MAIL_ENABLED`                    | Adds a BCC field to the Mail activity in campaigns.                                  | Read          | Read        | Read                   | Read + change  |

### SMS & IM

| Setting                                                              | Key                           | What it does                                                         | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| -------------------------------------------------------------------- | ----------------------------- | -------------------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Enable Instant Messaging (SMS, WhatsApp, Viber, Telegram, Custom IM) | `_system_send_smss`           | Turns instant messages (SMS, WhatsApp, Viber, Telegram) on or off.   | Read + change | Read        | Read                   | Read + change  |
| Instant message sending hours (SMS, WhatsApp, Viber)                 | `SMS_ACTIVE_HOURS`            | Hours when instant messages may be sent.                             | Read + change | Read        | Read                   | Read + change  |
| SMS unsubscribe page (mail asset ID)                                 | `UNSUBSCRIBE_SMS_RESOURCE_ID` | Your own opt-out page for SMS.                                       | Read          | Read        | Read                   | Read + change  |
| Keep full links in SMS (no short links)                              | `SKIP_SMS_URL_SHORTING`       | Sends links in SMS as they are, without tracked short links.         | Read + change | Read        | Read                   | Read + change  |
| SMS opt-out properties for "Send only if"                            | `SMS_CUSTOM_OPTOUT_PROPS`     | Yes/no properties offered in "Send only if" of the SMS activity.     | Read          | Read        | Read                   | Read + change  |
| SMS bounce rules                                                     | `SMS_BOUNCE_STRATEGY`         | Which phone status an SMS provider failure reason sets.              | Read          | Read        | Read                   | Read + change  |
| Opt out the player when the SMS provider reports an opt-out          | `COMS_OPT_OUT_STATUS_TOGGLE`  | Opts the player out when the SMS provider says the player opted out. | Read          | Read        | Read                   | Read + change  |

### Push notifications

| Setting                                              | Key                          | What it does                                                                                   | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ---------------------------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Enable push notifications                            | `_system_send_pushes`        | Turns push notifications on or off.                                                            | Read + change | Read        | Read                   | Read + change  |
| Show Huawei fields in Push assets                    | `_system_send_huawei_pushes` | Shows Huawei fields in push assets.                                                            | Read          | Read        | Read                   | Read + change  |
| Push sending hours                                   | `PUSH_ACTIVE_HOURS`          | Hours when push notifications may be sent.                                                     | Read + change | Read        | Read                   | Read + change  |
| Firebase web app config for push notifications       | `FCM_CLIENT_CONFIG`          | Firebase web app config for push. Hidden through the MCP when it holds an API key.             | Read + change | Read        | Read                   | Read + change  |
| Firebase / Huawei server keys for push notifications | `FCM_SERVER_CONFIG`          | Hidden: holds a credential. Through the MCP its value is never shown and it cannot be changed. | Read + change | —           | —                      | Read + change  |
| Domain used in Push preview UI                       | `PUSH_BO_PREVIEW_DOMAIN`     | Domain shown in the push preview in the Back Office.                                           | Read + change | Read        | Read                   | Read + change  |
| Default push notification icon                       | `FCM_PUSH_DEFAULT_ICON_URL`  | Push icon used when the push asset has none.                                                   | Read + change | Read        | Read                   | Read + change  |
| Path to the push service worker file                 | `FCM_SW_URL_V2`              | Where the push service worker file is on your site.                                            | Read + change | Read        | Read                   | Read + change  |
| Push opt-out properties for "Send only if"           | `PUSH_CUSTOM_OPTOUT_PROPS`   | Yes/no properties offered in "Send only if" of the Push activity.                              | Read          | Read        | Read                   | Read + change  |

### Inbox

| Setting                                  | Key                       | What it does                              | CRM Admin | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ---------------------------------------- | ------------------------- | ----------------------------------------- | --------- | ----------- | ---------------------- | -------------- |
| Custom data fields for the inbox message | `CRM_CUSTOM_FIELDS_INBOX` | Your own extra fields for inbox messages. | Read      | Read        | Read                   | Read + change  |

### IVR

| Setting           | Key                | What it does                      | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ----------------- | ------------------ | --------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Enable IVR        | `_system_send_ivr` | Turns IVR calls on or off.        | Read + change | Read        | Read                   | Read + change  |
| IVR calling hours | `IVR_ACTIVE_HOURS` | Hours when IVR calls may be made. | Read + change | Read        | Read                   | Read + change  |

### General (channels)

| Setting                                                     | Key                                         | What it does                                                               | CRM Admin     | CRM Manager   | CRM Manager + Engineer | Smartico staff |
| ----------------------------------------------------------- | ------------------------------------------- | -------------------------------------------------------------------------- | ------------- | ------------- | ---------------------- | -------------- |
| Send messages also to players with these statuses           | `SEND_COMS_ALLOWED_STATUSES`                | Account statuses that also get messages, besides Active.                   | Read + change | Read          | Read                   | Read + change  |
| Also send 'Operational' campaign messages to these statuses | `SEND_COMS_ALLOWED_STATUSES_OPS_CAMPAIGN`   | More account statuses that get messages of "Operational" campaigns.        | Read          | Read + change | Read + change          | Read + change  |
| Gateway selection: 1st user property (ID)                   | `GATEWAY_SELECTION_CJM_PROPERTY_ID`         | First property used to pick a gateway automatically.                       | Read          | Read          | Read                   | Read + change  |
| Gateway selection: 2nd user property (ID)                   | `GATEWAY_SELECTION_CJM_PROPERTY_ID2`        | Second property used to pick a gateway automatically.                      | Read          | Read          | Read                   | Read + change  |
| Short link domain (SMS and IM)                              | `Short URL - Domain`                        | Domain of tracked short links in SMS and instant messages.                 | Read          | Read          | Read                   | Read + change  |
| Allow personal messages to opted-out players                | `ALLOW_PERSONAL_MESSAGE_FOR_OPTEDOUT_USERS` | Lets the "Send message" button work for opted-out or blocked players.      | Read          | Read          | Read                   | Admins only    |
| Send to players without email or phone in Smartico          | `SEND_COMS_EMPTY_ADDRESS`                   | Sends mails and IVR calls even when Smartico has no address of the player. | Read          | Read          | Read                   | Read + change  |
| Click tracking URL for email links                          | `_system_new_click_service_url`             | Your own domain for click tracking of mail links.                          | Read          | Read          | Read                   | Read + change  |
| IP addresses whose link clicks count as bots                | `BLOCKED_CLICK_IPS`                         | Link clicks from these IP addresses count as bots and are not reported.    | Read          | Read          | Read                   | Read + change  |

### Campaigns

| Setting                                                  | Key                                          | What it does                                                  | CRM Admin | CRM Manager | CRM Manager + Engineer | Smartico staff |
| -------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------- | --------- | ----------- | ---------------------- | -------------- |
| Allow popups anywhere in scheduled campaigns             | `ALLOW_POPUPS_IN_SCHEDULED_CAMPAIGNS_ALWAYS` | Lets a popup step stand anywhere in a scheduled campaign.     | Read      | Read        | Read                   | Read + change  |
| Lowest speed allowed in the BO, starts per minute        | `SCHEDULED_CAMPAIGN_MIN_THROTTLING_BO`       | Lowest speed you can enter for a scheduled campaign or rule.  | Read      | Read        | Read                   | Read + change  |
| Highest speed allowed in the BO, starts per minute       | `SCHEDULED_CAMPAIGN_MAX_THROTTLING_BO`       | Highest speed you can enter for a scheduled campaign or rule. | Read      | Read        | Read                   | Read + change  |
| Default speed for new scheduled items, starts per minute | `SCHEDULED_CAMPAIGN_DEFAULT_SPEED_PER_MIN`   | Default speed of a new scheduled campaign or rule.            | Read      | Read        | Read                   | Read + change  |
| Enable "Maximum number of entries per user" in campaigns | `LIMIT_CAMPAIGN_ENTRY_NUMBER_ENABLED`        | Adds a limit of entries per player to the campaign form.      | Read      | Read        | Read                   | Read + change  |

### Notifications & contacts

| Setting                                              | Key                        | What it does                                                                                   | CRM Admin     | CRM Manager   | CRM Manager + Engineer | Smartico staff |
| ---------------------------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------- | ------------- | ------------- | ---------------------- | -------------- |
| Email for system alerts about campaign problems      | `CRM_MANAGER_MAIL_ADDRESS` | Where Smartico sends alerts about problems in your campaigns and messages.                     | Read + change | Read          | Read                   | Read + change  |
| Support team email(s) for the "Mail to support" step | `Label Support Email`      | Addresses of the "Mail to support" step.                                                       | Read + change | Read          | Read                   | Read + change  |
| Risk team email for the "Mail to risk" step          | `RISK_MAIL_ADDRESS`        | Address of the "Mail to risk" step.                                                            | Read + change | Read          | Read                   | Read + change  |
| Slack webhook URL for the "Slack" campaign step      | `SlackWebhook`             | Hidden: holds a credential. Through the MCP its value is never shown and it cannot be changed. | Read + change | Read + change | Read + change          | Read + change  |

### Segments & Query builder

| Setting                                                      | Key                                     | What it does                                                                             | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ------------------------------------------------------------ | --------------------------------------- | ---------------------------------------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Allow hourly rebuild of behavioral and common-cases segments | `BEHAVIORAL_SEGMENTS_ALLOW_HOURLY_CALC` | Adds an "Hourly" rebuild option to behavioral and common-cases segments.                 | Read          | Read        | Read                   | Read + change  |
| Import segments by user ID only (ignore brand column)        | `ALLOW_SEGMENT_IMPORT_WITHOUT_BRAND_ID` | CSV segment import finds players by their external ID only and ignores the brand column. | Read + change | Read        | Read                   | Read + change  |
| Max rows in one Back Office CSV export                       | `BO_DATA_EXPORT_MAX_RECORDS`            | Largest number of rows in one CSV export from a Back Office list.                        | Read          | Read        | Read                   | Read + change  |
| Max number of behavioral segments                            | `SEGMENTS_LIMIT_BEHAVIOR_BASED`         | Most behavioral segments the label can have.                                             | Read          | Read        | Read                   | Read + change  |
| Max number of user state segments                            | `SEGMENTS_LIMIT_STATE_BASED`            | Most user state segments the label can have.                                             | Read          | Read        | Read                   | Read + change  |
| Max number of 'common cases' segments                        | `SEGMENTS_LIMIT_COMMON_CASES`           | Most common-cases segments the label can have.                                           | Read          | Read        | Read                   | Read + change  |
| Max players in one segment export                            | `SEGMENTS_EXPORT_MAX_RECORDS`           | Most players in one segment export file.                                                 | Read          | Read        | Read                   | Read + change  |
| Show only languages and countries seen on players            | `LANG_AND_COUNTRIES_SHOW_ONLY_USED`     | Condition builders list only languages and countries your players have.                  | Read + change | Read        | Read                   | Read + change  |
| Allow export of player email and phone                       | `ALLOW_EXPORT_EMAIL_PHONE_AS_SEGMENT`   | Lets exports of segments and lists include player email and phone.                       | Read          | Read        | Read                   | Read + change  |

### Automation rules

| Setting                                                   | Key                                       | What it does                                                            | CRM Admin | CRM Manager | CRM Manager + Engineer | Smartico staff |
| --------------------------------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------- | --------- | ----------- | ---------------------- | -------------- |
| Max activities from one accumulation-rule trigger         | `AUTOMATION_RULES_MAX_ACTIVITY_TIMES`     | How many times one event can give the activity of an accumulation rule. | Read      | Read        | Read                   | Read + change  |
| Allow 'Minutes' in accumulation reset of automation rules | `AUTOMATION_RULES_ALLOW_RESET_PER_MINUTE` | Adds a "Minutes" option to the accumulation reset of real-time rules.   | Read      | Read        | Read                   | Read + change  |
| Allow 'Hourly' schedule in scheduled automation rules     | `ENABLE_HOURLY_SCHEDULE_IN_AR`            | Adds an "Hourly" option to scheduled automation rules.                  | Read      | Read        | Read                   | Read + change  |

## Gamification

### General

| Setting                                                | Key                                               | What it does                                                         | CRM Admin     | CRM Manager   | CRM Manager + Engineer | Smartico staff |
| ------------------------------------------------------ | ------------------------------------------------- | -------------------------------------------------------------------- | ------------- | ------------- | ---------------------- | -------------- |
| Gamification widget skins available to the label       | `GAMIFICATION_AVAILABLE_SKINS`                    | Widget skins you can choose.                                         | Read          | Read          | Read                   | Read + change  |
| Gamification control group, %                          | `GAMIFICATION_CONTROL_GROUP_PERCENT`              | Share of new players put in the gamification control group.          | Read          | Read          | Read                   | Read + change  |
| Mask names of other players                            | `_system_gamification_mask_username`              | Partly hides other players' names in the widget.                     | Read + change | Read          | Read                   | Read + change  |
| Exclude test players from leaderboards                 | `_system_block_leader_board_points_for_test_user` | Points of test players do not go to leaderboards.                    | Read + change | Read          | Read                   | Read + change  |
| Stop giving points (emergency switch)                  | `_system_block_giving_points`                     | Every attempt to give points fails (for incidents).                  | Read + change | Read          | Read                   | Read + change  |
| Replace tags in mini-game prizes and nested label tags | `REPLACE_TAGS_FOR_EVERYTHING`                     | Also replaces tags in mini-game prizes and in nested label tags.     | Read          | Read          | Read                   | Read + change  |
| Send event when a mission task is completed            | `ENABLE_MISSION_TASK_COMPLETED_EVENT`             | Creates an event each time a player completes a mission task.        | Read          | Read          | Read                   | Read + change  |
| Visitor mode: test player external ID                  | `GAMIFICATION_VISTOR_MODE_USER_EXT_ID`            | Test player that visitor mode shows to people who are not logged in. | Read + change | Read + change | Read + change          | Read + change  |

### Avatars

| Setting                                              | Key                                                     | What it does                                                   | CRM Admin     | CRM Manager   | CRM Manager + Engineer | Smartico staff |
| ---------------------------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------- | ------------- | ------------- | ---------------------- | -------------- |
| Legacy avatars: image folder                         | `AVATAR_CUSTOM_IMAGE_FOLDER`                            | Folder with your own images for the legacy avatars.            | Read + change | Read + change | Read + change          | Read + change  |
| Legacy avatars: number of custom images              | `AVATAR_CUSTOM_IMAGE_MAX_ID`                            | How many images the legacy avatars folder holds.               | Read + change | Read + change | Read + change          | Read + change  |
| Avatars V2: turn on for                              | `GF_AVATARS_V2_ACTIVE_FOR`                              | Who sees the new avatars: all players, test players or nobody. | Read + change | Read          | Read                   | Read + change  |
| Avatars V2: AI customization on for                  | `GF_AVATARS_V2_AI_CUSTOMIZATION_ACTIVE_FOR`             | Who can change avatars with AI.                                | Read + change | Read          | Read                   | Read + change  |
| Avatars V2: AI customizations per month, whole label | `GF_AVATARS_V2_AI_CUSTOMIZATION_CREDITS_MONTHLY`        | AI avatar changes per month for all players together.          | Read          | Read          | Read                   | Read + change  |
| Avatars V2: AI customizations per player per month   | `GF_AVATARS_V2_AI_CUSTOMIZATION_CREDITS_PER_USER_MONTH` | AI avatar changes per player per month.                        | Read + change | Read          | Read                   | Read + change  |

### Tournaments

| Setting                                                  | Key                                      | What it does                                                       | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| -------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------ | ------------- | ----------- | ---------------------- | -------------- |
| Max players per tournament                               | `TOURNAMENT_MAX_REGISTRATION_LIMIT`      | Highest min. and max. players you can save in a tournament.        | Read          | Read        | Read                   | Read + change  |
| Max tournament duration, days                            | `TOURNAMENT_MAX_DAYS_DURATION`           | Longest tournament duration you can save.                          | Read          | Read        | Read                   | Read + change  |
| Max days to show a finished tournament                   | `TOURNAMENT_MAX_DAYS_SHOW_AFTER_FINISH`  | Most days a finished tournament can stay in the lobby.             | Read          | Read        | Read                   | Read + change  |
| Max number of tournament places                          | `TOURNAMENT_PLACE_LIMIT`                 | How many players the tournament leaderboard shows.                 | Read          | Read        | Read                   | Read + change  |
| Max top players for 'Tournament: leaderboard update'     | `TOUR_SEND_POSITION_EVENT_TOP_X_PLAYERS` | Highest "Send event to X top users" you can save in a tournament.  | Read          | Read        | Read                   | Read + change  |
| Allow 'Auto' registration in tournaments                 | `TOURNAMENTS_ENABLE_AUTO_OPTIN_BUYIN`    | Lets a tournament use the "Auto (all users)" registration.         | Read          | Read        | Read                   | Read + change  |
| Show pending registrations on the tournament leaderboard | `SHOW_PENDING_REGISTRATIONS`             | Shows players who wait for approval on the tournament leaderboard. | Read + change | Read        | Read                   | Read + change  |
| Convert bet and win amounts to the label currency        | `TOURNAMENT_CONVERT_MONEY_TO_BASE`       | Converts bet and win amounts to the label currency before scoring. | Read          | Read        | Read                   | Read + change  |
| Delay tournament finalization, minutes                   | `TOURNAMENT_FINALIZING_DELAY_MINUTES`    | Extra minutes after a tournament run when late events still count. | Read          | Read        | Read                   | Read + change  |
| Send 'Tournament: lose' event to players who did not win | `TOURNAMENT_SEND_LOST_EVENTS`            | Players who did not win get a "lose" event at the end of a run.    | Read          | Read        | Read                   | Admins only    |
| Tournament analytics: include events with 0 score        | `STORE_EVENTS_WITHOUT_PROGRESS`          | Tournament analytics also keeps events that added no score.        | Read          | Read        | Read                   | Read + change  |
| Custom fields for tournaments                            | `GF_CUSTOM_FIELDS_TOURNAMENT`            | Your own extra fields for tournaments.                             | Read          | Read        | Read                   | Read + change  |

### Clans

| Setting                                                 | Key                                 | What it does                                                       | CRM Admin | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------ | --------- | ----------- | ---------------------- | -------------- |
| Maximum number of clans                                 | `CLAN_MAX_COUNT`                    | Most clans the label can have.                                     | Read      | Read        | Read                   | Read + change  |
| Let players switch clans in the widget                  | `CLAN_ALLOW_USER_SWITCH`            | Lets players switch clans in the widget.                           | Read      | Read        | Read                   | Read + change  |
| Clan switch cooldown, days                              | `CLAN_COOLDOWN_DAYS`                | Days before a player can switch clans again.                       | Read      | Read        | Read                   | Read + change  |
| Let players rejoin clan tournaments after a clan switch | `CLAN_TOURNAMENT_REENTRY_ON_SWITCH` | Lets a player who switched clans rejoin a running clan tournament. | Read      | Read        | Read                   | Read + change  |
| Remove a player's score from the clan when they leave   | `CLAN_SCORE_DEDUCT_ON_LEAVE`        | Takes a leaving player's score off the clan total.                 | Read      | Read        | Read                   | Read + change  |
| Clan rating period, days                                | `CLAN_RATING_WINDOW_DAYS`           | How many last days of clan tournaments the clan rating counts.     | Read      | Read        | Read                   | Read + change  |
| Clan rating penalty for a skipped tournament, points    | `CLAN_PENALTY_ON_TOURNAMENT_SKIP`   | Rating points a clan gets for each clan tournament it skipped.     | Read      | Read        | Read                   | Read + change  |
| Clan member points reset schedule                       | `CLAN_USER_POINTS_RESET_CRON`       | When member points inside every clan go back to 0.                 | Read      | Read        | Read                   | Read + change  |

### Jackpots

| Setting                                           | Key                                  | What it does                                                 | CRM Admin | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------ | --------- | ----------- | ---------------------- | -------------- |
| Jackpot hard limit above max amount, %            | `JP_HARD_LIMIT_PERCENTAGE_ABOVE_MAX` | How far a jackpot may pass its max amount.                   | Read      | Read        | Read                   | Read + change  |
| Max explode amount for multi-player jackpots, EUR | `JP_MULTI_USER_MAX_POT_IN_EUR`       | Highest max amount of a multi-player jackpot.                | Read      | Read        | Read                   | Read + change  |
| Max explode amount for personal jackpots, EUR     | `JP_PERSONAL_MAX_POT_IN_EUR`         | Highest max amount of a personal jackpot.                    | Read      | Read        | Read                   | Read + change  |
| Daily cap for jackpot wins before manual approval | `JP_DAILY_CAP_OF_POT`                | Total jackpot wins per day; wins above it wait for approval. | Read      | Read        | Read                   | Read + change  |
| Custom fields for jackpots                        | `GF_CUSTOM_FIELDS_JACKPOT`           | Your own extra fields for jackpots.                          | Read      | Read        | Read                   | Read + change  |

### Raffles

| Setting                                   | Key                                   | What it does                                                 | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ----------------------------------------- | ------------------------------------- | ------------------------------------------------------------ | ------------- | ----------- | ---------------------- | -------------- |
| Custom fields for raffles                 | `GF_CUSTOM_FIELDS_RAFFLE`             | Your own extra fields for raffles.                           | Read          | Read        | Read                   | Read + change  |
| Custom fields for raffle prizes           | `GF_CUSTOM_FIELDS_RAFFLE_PRIZE`       | Your own extra fields for raffle prizes.                     | Read          | Read        | Read                   | Read + change  |
| Max number of tickets per raffle          | `RAFFLE_MAX_TICKETS_COUNT_PER_RAFFLE` | Highest ticket limit you can save in a raffle.               | Read          | Read        | Read                   | Read + change  |
| Max raffle duration, days                 | `RAFFLE_MAX_DURATION_DAYS`            | Longest raffle period you can save.                          | Read          | Read        | Read                   | Read + change  |
| Block raffle tickets for non-active users | `RAFFLE_TICKETS_CHECK_ACCOUNT_STATUS` | No raffle tickets for players who are not Active or Pending. | Read + change | Read        | Read                   | Read + change  |

### Missions & Badges

| Setting                                                  | Key                                       | What it does                                                                      | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| -------------------------------------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Maximum number of active missions                        | `MAX_ACTIVE_MISSIONS`                     | Most missions that can be active at once.                                         | Read          | Read        | Read                   | Read + change  |
| Maximum number of active badges                          | `MAX_ACTIVE_BADGES`                       | Most badges that can be active at once.                                           | Read          | Read        | Read                   | Read + change  |
| Show completed missions and badges outside their segment | `SHOW_COMPLETED_GAMIFICATION_NOT_VISIBLE` | Completed missions and badges stay visible after the player leaves their segment. | Read + change | Read        | Read                   | Read + change  |
| Custom fields for missions and badges                    | `GF_CUSTOM_FIELDS_ACH`                    | Your own extra fields for missions and badges.                                    | Read          | Read        | Read                   | Read + change  |

### Levels

| Setting                                           | Key                                          | What it does                                                          | CRM Admin | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ------------------------------------------------- | -------------------------------------------- | --------------------------------------------------------------------- | --------- | ----------- | ---------------------- | -------------- |
| Level logic: points + behavior counters           | `GAMIFICATION_LEVELS_LOGIC2`                 | Levels need points plus up to 2 behavior counters.                    | Read      | Read        | Read                   | Read + change  |
| Level logic: behavior counters definition         | `GAMIFICATION_LEVELS_LOGIC2_DEFINITION`      | The behavior counters and their SQL.                                  | Read      | Read        | Read                   | Read + change  |
| Level logic: recalculation schedule (cron)        | `GAMIFICATION_LEVELS_LOGIC2_REBUILD_CRON`    | Schedule of the counter recalculation.                                | Read      | Read        | Read                   | Read + change  |
| Level logic: last recalculation time              | `GAMIFICATION_LEVELS_LOGIC2_LAST_REBUILT_TS` | When the counters were last recalculated (set by the system).         | Read      | Read        | Read                   | Read + change  |
| Level logic: next recalculation time              | `GAMIFICATION_LEVELS_LOGIC2_NEXT_REBUILT_TS` | When the counters are recalculated next (set by the system).          | Read      | Read        | Read                   | Admins only    |
| Level logic: manual (points do not change levels) | `GAMIFICATION_LEVELS_LOGIC3`                 | Points never change levels; levels change only by hand or by rewards. | Read      | Read        | Read                   | Read + change  |
| Custom fields for levels                          | `GF_CUSTOM_FIELDS_LEVEL`                     | Your own extra fields for levels.                                     | Read      | Read        | Read                   | Read + change  |

### Store

| Setting                       | Key                       | What it does                                   | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ----------------------------- | ------------------------- | ---------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Hide all store items          | `_system_block_store`     | The store shows no items (emergency switch).   | Read + change | Read        | Read                   | Read + change  |
| Block all store purchases     | `_system_block_store_buy` | Every store purchase fails (emergency switch). | Read + change | Read        | Read                   | Read + change  |
| Custom fields for store items | `GF_CUSTOM_FIELDS_STORE`  | Your own extra fields for store items.         | Read          | Read        | Read                   | Read + change  |

### Mini-games

| Setting                               | Key                                | What it does                                   | CRM Admin | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ------------------------------------- | ---------------------------------- | ---------------------------------------------- | --------- | ----------- | ---------------------- | -------------- |
| Custom fields for mini-game templates | `GF_CUSTOM_FIELDS_MINI_GAME`       | Your own extra fields for mini-game templates. | Read      | Read        | Read                   | Read + change  |
| Custom fields for mini-game prizes    | `GF_CUSTOM_FIELDS_MINI_GAME_PRIZE` | Your own extra fields for mini-game prizes.    | Read      | Read        | Read                   | Read + change  |

## Brand settings

### General

| Setting                                         | Key                             | What it does                                                                                   | CRM Admin     | CRM Manager   | CRM Manager + Engineer | Smartico staff |
| ----------------------------------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------- | ------------- | ------------- | ---------------------- | -------------- |
| Property for public name of user                | `PUBLIC_USERNAME_PROPERTY_NAME` | Properties used as the player's public name.                                                   | Read          | Read          | Read                   | Read + change  |
| Domains where the Smartico script may run       | `FRONT_END_ALLOW_DOMAINS`       | Domains where the Smartico script may run.                                                     | Read + change | Read + change | Read + change          | Read + change  |
| Deep link URL of your website                   | `WEB_SITE_DP_HANDLER`           | Page of your site that runs deep links.                                                        | Read + change | Read + change | Read + change          | Read + change  |
| Custom JavaScript run by the Smartico script    | `JS_INJECTION`                  | Your own JavaScript that the Smartico script runs on each page load.                           | Read + change | Read + change | Read + change          | Read + change  |
| Public key of shadow label                      | `SHADOW_LABEL_PUBLIC_KEY`       | Public key of the shadow label in a master and shadow label setup.                             | Read          | Read          | Read                   | Read + change  |
| Slack webhook URL for the "Slack" campaign step | `SlackWebhook`                  | Hidden: holds a credential. Through the MCP its value is never shown and it cannot be changed. | Read + change | Read + change | Read + change          | Read + change  |

### Push notification

| Setting                                              | Key                 | What it does                                                                                   | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ---------------------------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| FireBase Sender ID (deprecated)                      | `FCM_SENDER_ID`     | Old Firebase sender ID (deprecated).                                                           | Read          | Read        | Read                   | Read + change  |
| Firebase web app config for push notifications       | `FCM_CLIENT_CONFIG` | Firebase web app config for push. Hidden through the MCP when it holds an API key.             | Read + change | Read        | Read                   | Read + change  |
| Firebase / Huawei server keys for push notifications | `FCM_SERVER_CONFIG` | Hidden: holds a credential. Through the MCP its value is never shown and it cannot be changed. | Read + change | —           | —                      | Read + change  |

### Mails

| Setting                            | Key                             | What it does                                               | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| ---------------------------------- | ------------------------------- | ---------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Enable mails                       | `_system_send_emails`           | Turns mail sending on or off.                              | Read + change | Read        | Read                   | Read + change  |
| Click tracking URL for email links | `_system_new_click_service_url` | Your own domain for click tracking of mail links.          | Read          | Read        | Read                   | Read + change  |
| Short link domain (SMS and IM)     | `Short URL - Domain`            | Domain of tracked short links in SMS and instant messages. | Read          | Read        | Read                   | Read + change  |

### Gamification

| Setting                                             | Key                                    | What it does                                                         | CRM Admin     | CRM Manager   | CRM Manager + Engineer | Smartico staff |
| --------------------------------------------------- | -------------------------------------- | -------------------------------------------------------------------- | ------------- | ------------- | ---------------------- | -------------- |
| Disable missions and gamification UI for this brand | `GAMIFICATION_DISABLE_FOR_BRAND`       | Turns off missions, badges and the gamification UI for a brand.      | Read + change | Read + change | Read + change          | Read + change  |
| Visitor mode: test player external ID               | `GAMIFICATION_VISTOR_MODE_USER_EXT_ID` | Test player that visitor mode shows to people who are not logged in. | Read + change | Read + change | Read + change          | Read + change  |
| Legacy avatars: image folder                        | `AVATAR_CUSTOM_IMAGE_FOLDER`           | Folder with your own images for the legacy avatars.                  | Read + change | Read + change | Read + change          | Read + change  |
| Legacy avatars: number of custom images             | `AVATAR_CUSTOM_IMAGE_MAX_ID`           | How many images the legacy avatars folder holds.                     | Read + change | Read + change | Read + change          | Read + change  |
| Gamification control group, %                       | `GAMIFICATION_CONTROL_GROUP_PERCENT`   | Share of new players put in the gamification control group.          | Read          | Read          | Read                   | Read + change  |

### Bonuses

| Setting                                 | Key                          | What it does                                               | CRM Admin     | CRM Manager | CRM Manager + Engineer | Smartico staff |
| --------------------------------------- | ---------------------------- | ---------------------------------------------------------- | ------------- | ----------- | ---------------------- | -------------- |
| Max bonuses per test player per day     | `BONUS_TEST_USER_CAP_COUNT`  | Highest number of bonuses one test player can get per day. | Read + change | Read        | Read                   | Read + change  |
| Max bonuses per player per day          | `BONUS_CAP_COUNT`            | Highest number of bonuses one real player can get per day. | Read + change | Read        | Read                   | Read + change  |
| Max total bonus cost per player per day | `BONUS_CAP_AMOUNT`           | Highest total bonus cost one player can get per day.       | Read          | Read        | Read                   | Read + change  |
| Give bonuses to non-active players      | `BONUS_CHECK_ACCOUNT_STATUS` | Gives bonuses whatever the player account status is.       | Read + change | Read        | Read                   | Read + change  |


---

# 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://help.smartico.ai/welcome/technical-guides/mcp-server/mcp-label-settings-by-role.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.
