Docs → Clan 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.
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.
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
| Card | What it controls |
|---|---|
| 🏰 Clan Information | Name, initials, kingdom number, capital coordinates and capital level. |
| 🌐 Clan Profile | Tagline, description, Message of the Day, Discord and website links — and whether the description and MOTD are pushed into the game. |
| ⚖️ Penalty System | The four automatic penalty rules. |
| 🔔 Admin Portal Notifications | The inactivity threshold — plus thirteen alert switches that do not currently gate anything. See the warning further down before you rely on them. |
| 📜 Clan Rules & Quiz | The rules text, whether members must accept it, and the five-question quiz. |
| 💪 Might Level Brackets | Named Might ranges used by cycle and event requirements and by the distribution chart. |
| 🎨 Branding | Clan shield and banner images. |
| 👥 Clan Member Groups | Saved groups of members, built from rules or hand-picked. |
| 📡 Chest Grabber | The account that reads your clan in the game — status, usage and a link to manage it. |
| 👤 User Requests | Pending sign-ups, and whether they are approved automatically. |
| 🤖 ChatBot | The in-game chat bot and the welcome message for new members. |
| 🌍 Public Crypt Access | A shareable link to your chest statistics for people outside the clan. |
| 🔗 Webhook & Chest Import | Your own chest-import endpoint and key, plus two import behaviours. |
| 💬 Discord Webhooks | Sending portal events to Discord channels. |
| 🧩 Member Widget Visibility | Which dashboard widgets members may see. |
| ⚔️ Captain Settings | Which 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.
| Rule | Applies to |
|---|---|
| Crypt Penalty | Members 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 Penalty | Members 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 Penalty | Members with no portal account linked. |
| Login Penalty | Accounts that logged into the portal on fewer than Minimum login days per cycle separate days. |
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.
💪 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.
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.
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.
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.
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.
Related