Docs → Getting Started → Linking your players
🔗 Linking your players
Attach a second, third or fourth Total Battle player to the portal account you already have — and read the error message correctly when it will not take.
You play more than one account in Total Battle and you want all of them under one portal login, so you are not signing in and out to see who owes what. That is exactly what linking does, and it takes about a minute per player — once you have the invite code.
One rule governs everything below, so here it is first:
Getting the invite code
Every player record in the portal carries its own invite code, generated once when your clan admin first imported or created the player. It never changes and it is not shown to you — it is how your clan proves that the player really is yours to claim.
Ask your clan admin for it. They find it at Clan Management → Clan Members, opening the player and reading Invite Code in the details. Many clans also send it out in the welcome message they post in game when someone joins, so check there before asking — the code, your player name and the clan initials are usually all three in that message, which is everything you need.
Linking a player to your account
Press ＋ Register Player, which sits both in the page header and in the 👥 My Players card. The ⚡ Quick Actions card has the same button under the plainer label Register Player. All three open the same panel.
Player Name is the exact in-game name of the player you are claiming. Clan Initials is the clan that player is currently in. Invite Code is the ten-character code.
Two answers mean it worked and three mean it did not. All five are explained below.
DWS and you type dws, and the portal answers Clan mismatch even though you have the right clan. Copy them from the welcome message rather than typing from memory.What happens after you submit
Which of two things happens next is decided by your clan, not by you.
| Your clan's setting | What you see | What you do |
|---|---|---|
| Requests approved automatically | Player Registered Successfully, naming the player and clan | Nothing. The player is in 👥 My Players straight away. |
| Requests reviewed by an admin | Request Submitted | Wait. A clan admin approves it at Clan Management → User Requests. Until they do, the player is not yours and does not appear anywhere. |
There is no separate place to check a pending request. If nothing has happened after a day, ask an admin to look at their User Requests list — the request sits there with your username against it.
When it will not take
| Message | What is actually wrong |
|---|---|
| Player not found | The invite code and the player name do not both belong to the same player. One of the two is wrong — most often a mistyped code, or a player name spelled the way you say it rather than the way it is written in game. |
| Clan mismatch | The code and name found a player, but that player is not in the clan whose initials you typed. Either you got the initials wrong — check the capitals — or the player has since moved clan and you need the initials of the clan they are in now. |
| Player Already Registered | Someone holds the link. See the next chapter. |
Taking over a player that is already linked
This is the common one when a member returns to the game, or when a player changes hands inside a clan. The old link has to be released before a new one can be made, and only a clan admin can do it.
Ask them to open Clan Management → Clan Members, find the player, and use Deactivate in the 🔗 User Relations card. That removes the old account's access to the player and nothing else — the player's chests, points, penalties and history stay exactly where they are. Once it is done, run the registration above and it will go through.
Your first player was linked for you
You never used this form for the player you signed up with. The sign-up wizard asked for the same three details — clan initials, invite code, player name — plus your troop levels and the login you wanted, and linked that player to the account it created. If your clan reviews requests, your account itself waited for approval before it existed.
That is also why an invite code can be refused during sign-up with a message about a pending request: someone has already started signing up with that player and the request has not been dealt with yet.
What changes once a player is linked
- The player appears in 👥 My Players with its player ID, its clan and its Guardsmen level, badged ● In Clan or No Clan.
- Its clan joins the 👤 Player Clans group in the clan selector at the top of the page, so you can switch to it.
- Your dashboard's Viewing as list gains the player. Pick it there and every widget re-scopes to that player and its clan.
- Its chest points, cycle status, penalties, CP balance and rewards become visible to you on the pages that report them.
- Clicking the player row opens a panel where you can correct its six research levels. Everything else on the card — might, hero level, city level, Gold Pass — is read-only and maintained from the game.
Common questions
Can I link players from more than one clan?
Yes, and there is no limit. Each linked player brings its clan into the 👤 Player Clans group of the clan selector, and you switch between them from the header. Only one clan is active at a time, so clan-wide pages always show one clan's figures — the one named next to the logo.
I am certain the code and name are right, but it still says the player was not found.
The code and the name have to belong to the same player. Two things cause this more than anything else: a player name that reads slightly differently in game than the way the clan says it out loud, and a code copied with a trailing space from a chat message. Ask your admin to read the code back to you from the player's own page, and to spell the name exactly as the portal has it.
The player is linked to my old account and I cannot log in to it any more.
You do not need to. Ask a clan admin to deactivate the old link on the player's page — that is enough for you to register the player on your current account. Nothing on the player's record is lost when a link is deactivated; the chests, points and history belong to the player, not to the account reading them.
Can I unlink a player myself?
No. Releasing a player is a clan-admin action, deliberately — it is what stops one member quietly claiming another member's account. If you want a player removed from your login, ask an admin to deactivate the relation for you.
Related