DocsClan Administration → Clan Settings

⚙️ Clan Settings

Find the right card on the Clan Settings page and know what changing it does — identity, penalties, rules, access, integrations and ownership.

Clan Administration 11 min read Reference Updated 23 Aug 2026

You know what you want to change; the question is which card it lives behind. Clan Management → Clan Settings is one page of cards, and each card opens its own panel with its own Save. There is no page-wide save button: what you save in one panel is saved, and every other card is untouched.

💡
How the page works
Every card has an Edit button that opens a panel from the right. The panel ends with Cancel and Save. Closing it without saving discards that panel's changes and nothing else. Configure Layout in the header lets you reorder the cards into the left and right columns, with Reset to default if you change your mind.

Any clan admin can edit every card. One action is restricted to the clan owner, and it is covered at the end.


Which card holds what

CardWhat it controls
🏰 Clan InformationName, initials, kingdom number, capital coordinates and capital level.
🌐 Clan ProfileTagline, description, Message of the Day, Discord and website links — and whether the description and MOTD are pushed into the game.
⚖️ Penalty SystemThe four automatic penalty rules.
🔔 Admin Portal NotificationsThe inactivity threshold — plus thirteen alert switches that do not currently gate anything. See the warning further down before you rely on them.
📜 Clan Rules & QuizThe rules text, whether members must accept it, and the five-question quiz.
💪 Might Level BracketsNamed Might ranges used by cycle and event requirements and by the distribution chart.
🎨 BrandingClan shield and banner images.
👥 Clan Member GroupsSaved groups of members, built from rules or hand-picked.
📡 Chest GrabberThe account that reads your clan in the game — status, usage and a link to manage it.
👤 User RequestsPending sign-ups, and whether they are approved automatically.
🤖 ChatBotThe in-game chat bot and the welcome message for new members.
🌍 Public Crypt AccessA shareable link to your chest statistics for people outside the clan.
🔗 Webhook & Chest ImportYour own chest-import endpoint and key, plus two import behaviours.
💬 Discord WebhooksSending portal events to Discord channels.
🧩 Member Widget VisibilityWhich dashboard widgets members may see.
⚔️ Captain SettingsWhich captains appear on member profiles and which are required.

Four figures sit above the cards: ChatBot, Public Crypt, Chest Grabber and Penalty Rules — the last counting how many of the four penalty rules are on.


Identity and profile

🏰 Clan Information holds Clan name (up to 100 characters), Clan initials (up to three), Kingdom number, Coordinates and Capital level (1-30). The initials matter more than they look: a member signing up has to type them exactly.

🌐 Clan Profile holds the public-facing text — Tagline, Description, Message of the Day, Discord invite URL and Website URL. The description and the MOTD are saved as plain text: any formatting you paste in is stripped, because these two can be written straight into the game, where formatting does not exist.

That is what Auto-push Description to game and Auto-push Message of the Day to game do — the value you save here replaces the one in Total Battle at the next chest scan. The card shows where each stands: In sync with game, Pending — portal newer than game, Last push failed or Never pushed to game.


Penalties

⚖️ Penalty System is one panel with four independent rules, each with its own on/off switch, Penalty Value and Penalty Chest.

RuleApplies to
Crypt PenaltyMembers who miss the chest target for a cycle. Use missing sum from last cycle makes the penalty equal exactly what they were short; with it off, a fixed value is used.
Gold Pass PenaltyMembers without a Gold Pass. When to apply penalty chooses between when a chest cycle closes and a fixed Day of month (1-28) at a Time (UTC) you set.
No-User PenaltyMembers with no portal account linked.
Login PenaltyAccounts that logged into the portal on fewer than Minimum login days per cycle separate days.
⚠️
The chest dropdown is empty until you make a penalty chest
Penalty Chest only lists chests in your catalogue that are marked as penalties. If it is empty, go to Clan Management → Chest Catalog, create a chest, tick the penalty flag and give it a negative point value. A rule with no chest selected has nothing to record itself as.
💡
The login penalty is about the account, not the player
It counts days on which somebody logged into the portal, so a member who plays every day but never opens the portal will collect it. If that is not what you meant, leave it off.

Individual members can be exempted on their own page, reached from Clan Management → Clan Members. What each rule produces and where the penalty lands is covered in the guide Understand the penalty system.


Rules, brackets and groups

📜 Clan Rules & Quiz

Your rules text, Require members to accept rules, and Enable rules quiz (5 questions). The quiz is five multiple-choice questions with answers A, B and C and one correct option each; all five must be right. The two switches are independent: the quiz can be turned on whether or not you require acceptance, and the five question blocks appear as soon as Enable rules quiz (5 questions) is on.

🚫
Editing the rules text resets everyone's acceptance
Changing the rules increments the rules version, and every member has to accept the new version before they can use clan features again — quiz included, if you have one. The card shows the current version and the date it last changed. Toggling the switches does not do this; editing the text does.

💪 Might Level Brackets

A list of named rows you add and remove yourself, each with a Name, a Min might and a Max might (leave 0 for unlimited). They are what a Might-bracket crypt cycle or event requirement measures against, and what the Might distribution chart uses. Removing a row deletes that bracket.

👥 Clan Member Groups

A saved set of members you want to address repeatedly: a rule tree plus a manual list. The tree combines conditions with ALL (AND) or ANY (OR), and nested boxes let you mix the two — a nested box counts as one condition in its parent. Conditions can test hero level, Might, Might bracket, T9 status, G/S/M/E/AM/MB level, Gold Pass, VIP level, city level and rank. Anyone in Manual members is included whatever the rules say, and the panel tells you how many members match before you save.


Access and integrations

User Requests

The card lists sign-ups awaiting review, with Approve and Reject on each. The one setting is Auto-approve User Signup Requests — with it on, a valid sign-up creates the account immediately and this card stays empty. The full queue lives at Clan Management → User Requests.

Public Crypt Access

Publishes your chest statistics on a link anyone can open. Three access types: Open (no check at all), Password (with a Generate Random Password button), and Token-based, where members request a personal token that lasts for the Token expiry (days) you set — between 10 and 45 days, default 30. Token access requires the ChatBot, because that is how members ask for a token. The link appears on the card once it is on.

Webhook & Chest Import

For clans feeding chest data from their own tool. The card shows the Endpoint URL and the Webhook key, both click-to-copy. Requests carry the key in an X-Webhook-Key header and send application/json: an array of objects with chest_source, chest_name, player_name and date_collected. The panel shows the exact shape.

🚫
Regenerate Key breaks the old one instantly
There is no grace period and no way back to the previous key. Anything still sending the old one starts failing the moment you confirm, so have the new value ready to paste into your tool.

Two switches share this panel. Auto-import ready chests writes fully matched rows as soon as they are read, leaving only problem rows for the Import Dashboard — worth having on. Receive Global Chests copies newly published shared chest types into your own catalogue automatically.

Discord Webhooks

Add as many as you like, each pointing at one Discord channel with its own set of notification types. Each row has a Test button that posts to the channel so you can check it before relying on it, and the panel walks through creating the webhook inside Discord. Once at least one exists, members can link their own Discord account from their user settings to receive personal notifications.

ChatBot

ChatBot enabled switches on the in-game bot, and Send welcome message to new members plus Welcome message template control what a new member is sent. The template understands #playername#, #invitecode# and #claninitials#.

As you type, the panel flags web links, email addresses and emoji in the message. Total Battle refuses to deliver a message containing any of them, so take the warning seriously — a template that trips it will never arrive at all. Insert default message gives you a working starting point, and Resend welcome to all members sends it to everyone with a game account, in the background. The panel also states plainly that you are responsible for any consequence of running the bot, including an in-game chat ban.

🎯
Only with a working in-game connection
The ChatBot, welcome messages and token-based public crypt access all need a chest grabber account whose in-game connection is live. If yours is not set up, or its messaging connection has been disabled, the card says so and the features stay inert whatever you switch on.

Presentation cards

🎨 Branding takes a Shield image and a Banner image — PNG, WebP or JPEG. The fields are labelled for 2 MB, and anything above 5 MB is rejected outright. A square shield works best; the banner is used wide.

🧩 Member Widget Visibility decides which widgets members can put on their personal dashboard; everything is visible unless you hide it. If you came here looking for a card called Dashboard Widgets, this is it — Dashboard Widgets is a section heading inside the panel, not the name on the card.

⚔️ Captain Settings chooses which captains appear on member profile forms. Per captain: Show, Required, Min level (1–600) and Min star (1–7). A blank level means the member must own the captain, with no minimum.

🔔 Admin Portal Notifications holds Mark player inactive after (days), which defaults to 7: a member who has collected no chests for that many days is what the inactive-member alert reports. That figure works. The rest of the panel — thirteen switches grouped under Crypt, Events, Players, Chest Import, Rewards and Billing — does not, and the alert below explains what to expect instead. What actually arrives is read on MY → Notification Hub.

🚫
The thirteen alert switches do not currently switch anything
Each switch is named for an alert type, but none of those names matches an alert the portal actually raises, and an unrecognised name is treated as on. So every admin alert is delivered no matter what you set here: turning one off will not stop the alert arriving. It cuts the other way too — the switches open showing off until you change them, so a switch reading off is not evidence that anything is disabled. The Rewards and Billing groups are emptier still: no alert of either kind is created anywhere, so turning those on produces nothing. Treat the panel as read-only for now, use MY → Notification Hub to see and clear what actually arrives, and tell support if an alert is genuinely bothering you.

Things that are no longer here

Three settings people look for here are elsewhere. Announcements — channels, defaults and automatic announcements — live on Clan Management → Announcements. Chest cycle targets belong to each cycle, on Clan Management → Crypt Cycles; only the penalty rules are here. Chest grabber configuration is behind Manage → on its card, which itself shows status only.


Transfer ownership

The Transfer Ownership button appears in the header for the clan owner only. Name a successor either from the dropdown of clan admins with an active, email-verified account, or by looking up any portal user by email — the new owner need not be in your clan.

🚫
This cannot be undone from the portal
Ownership moves the moment you confirm, and you become an ordinary admin of the clan. Read the panel's own warnings before you confirm: subscriptions belong to users, not clans, so yours stays on your account and keeps billing at the same price — but the clan comes out of your clan slot, which frees that slot for another clan. Where the clan lands next depends on the new owner. If their subscription has a free slot, it moves straight onto it and nothing pauses. If they have no running subscription, or theirs is full, the clan ends up on none and collecting stops until they put it on a plan — nothing already collected is lost. The portal tells you which of the three happened. Chest grabber settings, by contrast, stay attached to the clan and the new owner inherits them, so reset yours first if that is not what you want.

Common questions

Where is the Save button?

Inside each panel, not on the page. Click Edit on the card you want to change and the panel that opens ends with Cancel and Save.

Each card saves independently, so there is nothing to lose by editing one card and leaving the rest alone — and closing a panel without saving discards only that panel's changes.

Who can change these settings?

Any admin of the clan you currently have selected, plus system administrators. Being an admin of a different clan gives you nothing here.

One action is narrower: Transfer Ownership is available to the clan owner only, and the button does not appear for anyone else.

The Penalty Chest dropdown is empty. Why?

It only lists chests in your clan's catalogue that are flagged as penalty chests, and you have none yet. A penalty is recorded as a chest with a negative point value, which is why the rule needs one.

Go to Clan Management → Chest Catalog, create a chest, tick the penalty flag, give it a negative point value, and come back — it will be in the dropdown. You can use a different chest for each of the four rules so that penalties are distinguishable later.

What happens if I edit the clan rules?

The rules version goes up by one and every member has to accept the new text before they can use clan features again. If the quiz is enabled they take it again too. There is no way to publish a correction quietly.

Only a change to the rules text does this. Turning acceptance or the quiz on and off, or editing a quiz question, leaves the version alone.