# Owner controls

# Owner controls

`/showlimits` reads back the dashboard's rate limits and blocks. User Limits, the Twitter whitelist, Owner Notifications and Transfer Bot Ownership are dashboard-only.

## /showlimits

`/showlimits` lists every blocked and rate-limited user on the bot — the same data as Management → User Limits. Private chat with the bot only, for the bot's owner. The slash is optional and `@botusername` is accepted.

#### What it prints

| Input | Output |
| --- | --- |
| No restrictions on the bot | `**User Restrictions**  No restrictions configured for this bot.` |
| 2 blocked users, 1 rate-limited user | `**User Restrictions for @examplebot**  **Blocked Users:**   @spammer1   @spammer2  **Rate Limited Users:**   @chris -- 25 commands/day` |

- [Rate limits and blocks](#rate-limits-and-blocks)

## Rate limits and blocks

Management → User Limits lists every per-user restriction on a bot. Each is either a **Rate Limit** (a daily command cap) or a **Block**. Rate Limit is the default.

#### Adding a restriction

1. Click **Add Restriction**.
2. Enter **Username** (leading `@` optional). The username can't be changed once saved.
3. Pick **Restriction Type**: Rate Limit or Block.
4. Rate Limit only: set **Daily Limit** — minimum 1, default 50, no maximum.
5. Pick **Restriction Duration**: Permanent (default), 1 hour, 1 day, 3 days or 7 days.
6. Click **Add Restriction** (**Save Changes** when editing).

#### Restriction rules

| Setting | Value |
| --- | --- |
| Duplicate username | `Restriction already set for @{username} on this bot` |
| Expired restrictions | Disappear from the list. |
| Deleting | Trash icon, then confirm. |
| Editing duration | Reopening a restriction to edit it always shows Permanent, regardless of what was saved. |

Every saved edit is added to that restriction's **Edit History** (clock icon next to the username), recording the previous type, daily limit and expiry.

- [/showlimits](#showlimits)
- [Twitter whitelist](#twitter-whitelist)

## Twitter whitelist

The Whitelist tab is for Twitter bots only. It controls which X accounts can trigger the bot by @mentioning it; mentions from anyone else are filtered out at X and never reach the bot.

#### Adding handles

1. Click **AddUsers**.
2. Paste handles — one per line, or comma/space-separated.
3. The preview shows how many are new, already listed, or rejected.
4. Click **Add {n} user(s)**.

#### Whitelist rules

| Setting | Value |
| --- | --- |
| Handle | Letters, numbers and underscore, 1–15 characters. Leading `@` optional. |
| Cap | 200 handles. |
| Removing | Trash icon on the row. No confirmation. |

> **Limit**
>
> Pasting more than the remaining room fails with `Combined list would exceed 200 entries (current: {n}, adding: {m})` and saves nothing.

## Owner notifications

Settings → Notifications (**Owner Notifications**) controls which dashboard edits DM the bot's owner. Three toggles, all on by default:

*Owner Notifications toggles*

| Toggle | DMs the owner when |
| --- | --- |
| Command Changes | Text or button commands are added, edited or removed. |
| Rate Limits & Blocks | Rate limits or blocked users change. |
| Profile Changes | The bot's name, bio or avatar changes. |

#### Two of the DMs

| Input | Output |
| --- | --- |
| Rate Limits & Blocks — adding a Rate Limit | `➕ **Rate Limit Set**  User: @chris Daily Limit: 25 prompts/day` |
| Command Changes — turning Admin Moderation on | `🛡️ **Moderation Updated**  Ban: Enabled Mute: Enabled` |

*The Moderation DM is gated by Command Changes, not Rate Limits & Blocks.*

- [The Admin Moderation switch](/telegram-bot/owner-moderation#the-admin-moderation-switch)

## Transfer Bot Ownership

Profile → Advanced Bot Settings → **Transfer Bot Ownership** moves a Telegram bot to another Telegram account. It is permanent: you lose access immediately and only the new owner can manage the bot. Changing your own @username needs no transfer — ownership follows your account.