Your Town Hall level sets the limit for everything else in your home village: how many buildings you can have, how far they and your heroes can be upgraded, and which troops, spells and defences exist for you at all. Below: how the upgrade works, the cost, time, unlocks and limits of every level from Town Hall 2 to 18, and what to upgrade first once the new level is in.
Quick answer: the Town Hall is upgraded with Gold and a free Builder. Before the game lets you start, you may have to build the new buildings your current level unlocked. The highest level today is Town Hall 18, which costs 25,000,000 Gold and takes 12 days. After each upgrade, start with the Laboratory, Army Camps and heroes, then the rest.
Every cost, time and unlock below comes from the game's own data files (release of 13 October 2026).
How to upgrade your Town Hall
- Have the Gold. Every Town Hall upgrade is paid in Gold, and your storage capacity has to cover the full cost, so upgrade your Gold Storages first if the next Town Hall does not fit.
- Free a Builder. The Town Hall upgrade takes one Builder for the whole upgrade time.
- Check the requirements. Tap the Town Hall and Upgrade. If something is missing, the game shows "Build the following buildings to unlock the next Town Hall level!" (or "Upgrade the following buildings…") with a list. Build or upgrade what it lists and the button unlocks.
- Start it. Builder Potions and other magic items that speed up builders work on the Town Hall too, and gems can finish it early.
One level has an extra requirement: at Town Hall 17 the Town Hall merges with the Eagle Artillery, and the game data requires the Eagle Artillery to be at level 7 for that.
Town Hall upgrade cost and time for every level
| Town Hall | Gold | Upgrade time |
|---|---|---|
| 2 | 1,000 | Instant |
| 3 | 4,000 | 30 minutes |
| 4 | 25,000 | 3 hours |
| 5 | 150,000 | 6 hours |
| 6 | 500,000 | 12 hours |
| 7 | 1,000,000 | 18 hours |
| 8 | 2,000,000 | 1 day |
| 9 | 2,500,000 | 2 days |
| 10 | 3,500,000 | 3 days |
| 11 | 4,000,000 | 5 days |
| 12 | 6,000,000 | 6 days |
| 13 | 9,000,000 | 7 days |
| 14 | 12,000,000 | 7 days 12 hours |
| 15 | 13,000,000 | 8 days |
| 16 | 15,000,000 | 9 days |
| 17 | 16,000,000 | 10 days |
| 18 | 25,000,000 | 12 days |
From Town Hall 2 to 18 the Town Hall alone costs 109,680,000 Gold. The jump to Town Hall 18 is the largest by far: 25,000,000 Gold, 9,000,000 more than Town Hall 17.
What each Town Hall unlocks
New building types, heroes, troops and spells that become available at each level. Most levels also raise how many of your existing buildings you can have and how far they go; the limits table below covers the Laboratory, army space and heroes.
| Town Hall | New buildings | New hero | New troops, spells and siege machines |
|---|---|---|---|
| 2 | Wall, Archer Tower | None | Archer, Goblin, Giant |
| 3 | Clan Castle, Laboratory, Mortar | None | Wall Breaker |
| 4 | Hero Hall, Air Defense | Barbarian King | Balloon |
| 5 | Spell Factory, Wizard Tower | None | Wizard, Lightning Spell |
| 6 | Air Sweeper | None | Healer, Healing Spell |
| 7 | Dark Elixir Storage, Dark Elixir Drill, Dark Barracks, Hidden Tesla | None | Dragon, Minion, Hog Rider, Rage Spell |
| 8 | Dark Spell Factory, Blacksmith, Bomb Tower | Archer Queen | P.E.K.K.A, Valkyrie, Golem, Poison Spell, Earthquake Spell |
| 9 | Helper Hut, X-Bow | Minion Prince | Baby Dragon, Witch, Lava Hound, Jump Spell, Freeze Spell, Haste Spell, Skeleton Spell |
| 10 | Inferno Tower | None | Miner, Bowler, Clone Spell, Bat Spell |
| 11 | Eagle Artillery | Grand Warden | Electro Dragon, Ice Golem, Invisibility Spell |
| 12 | Workshop | None | Yeti, Headhunter, Wall Wrecker, Battle Blimp, Stone Slammer, Overgrowth Spell |
| 13 | Scattershot | Royal Champion | Dragon Rider, Apprentice Warden, Siege Barracks, Log Launcher, Recall Spell |
| 14 | Pet House | None | Electro Titan, Druid, Flame Flinger, Ice Block Spell |
| 15 | Spell Tower, Monolith | Dragon Duke | Root Rider, Furnace, Battle Drill, Revive Spell, Angry Spell |
| 16 | Multi-Archer Tower, Ricochet Cannon | None | Thrower, Ruin Witch, Troop Launcher, Totem Spell |
| 17 | Multi-Gear Tower, Firespitter, Crafting Station | None | Meteor Golem, Sky Wagon |
| 18 | Revenge Tower, Super Wizard Tower | None | None |
For the army and the facts at a single level, each Town Hall page on ClashBuilder has its own block, for example Town Hall 17 or Town Hall 18.
Limits at each Town Hall
How far the Laboratory and each hero can go at every level, and the army camp space you attack with. A dot means the hero is not available yet.
| Town Hall | Laboratory | Army camp space | Barbarian King | Archer Queen | Minion Prince | Grand Warden | Royal Champion | Dragon Duke |
|---|---|---|---|---|---|---|---|---|
| 3 | 1 | 70 | · | · | · | · | · | · |
| 4 | 2 | 80 | 1 | · | · | · | · | · |
| 5 | 3 | 135 | 1 | · | · | · | · | · |
| 6 | 4 | 150 | 1 | · | · | · | · | · |
| 7 | 5 | 200 | 10 | · | · | · | · | · |
| 8 | 6 | 200 | 20 | 10 | · | · | · | · |
| 9 | 7 | 220 | 30 | 30 | 10 | · | · | · |
| 10 | 8 | 240 | 40 | 40 | 20 | · | · | · |
| 11 | 9 | 260 | 50 | 50 | 30 | 20 | · | · |
| 12 | 10 | 280 | 65 | 65 | 40 | 40 | · | · |
| 13 | 11 | 300 | 75 | 75 | 50 | 50 | 25 | · |
| 14 | 12 | 300 | 85 | 85 | 60 | 60 | 30 | · |
| 15 | 13 | 320 | 90 | 90 | 70 | 65 | 40 | 10 |
| 16 | 14 | 320 | 95 | 95 | 80 | 70 | 45 | 15 |
| 17 | 15 | 340 | 100 | 100 | 90 | 75 | 50 | 20 |
| 18 | 16 | 352 | 110 | 110 | 95 | 85 | 55 | 25 |
What to upgrade first after a new Town Hall
Most players start with attack, because attacks are where loot comes from, and work towards defence:
- Laboratory. Each new Town Hall raises the Laboratory by one level (see the limits table), and every troop and spell level waits on it. Extra Builders do not speed up research, so starting the Laboratory first saves the most time.
- Army Camps. More housing space improves every attack you make from then on.
- Heroes. Each new Town Hall raises your heroes' level limits (see the limits table). Keep at least one upgrading at all times, since every attack you make uses them.
- Spell Factories and the Clan Castle. More spells and Clan Castle space change which attacks you can use.
- New troops and the buildings that make them. Unlock the troops your strategy needs before the rest.
- Storages, when your next big upgrade does not fit.
- New defences, then upgrades to the ones you have.
- Walls, with whatever Gold and Elixir is left over. Wall upgrades are instant, which makes them the place for loot that would otherwise sit in full storages.
New buildings the game asks for before the next Town Hall (see step 3 above) fit in between: build them early, since they can block your next upgrade.
Should you upgrade your Town Hall now?
Upgrade when your offence is done or nearly done for your current level. That means Army Camps finished, the troops and spells you use researched, and your heroes close to their limit for the level. Defences and walls can lag a little behind.
Moving up early is called rushing. It can work if you keep your attack strong while you do it:
- Keep your heroes upgrading the whole time.
- Keep the Laboratory busy so your troops keep up with your Town Hall.
- Expect your defences to lag, and spend loot quickly so there is less to steal.
Rushing goes wrong when offence falls behind too: a high Town Hall with weak troops and heroes faces stronger bases without the army to beat them.
Early, middle and late Town Halls
Town Hall 2 to 7
Upgrades take minutes to hours, so the order matters less than keeping the Laboratory and every Builder busy. The Hero Hall and the Barbarian King arrive at Town Hall 4, Dark Elixir at Town Hall 7, and the King's real levels start there too (level 10 at Town Hall 7).
Town Hall 8 to 12
Upgrades start taking days and three more heroes arrive: the Archer Queen at 8, the Minion Prince at 9 and the Grand Warden at 11. A hero cannot fight while it is upgrading, so start hero upgrades after a war rather than just before one. At Town Hall 11, the Eagle Artillery is the only new defence, and the Grand Warden starts at a limit of 20.
Town Hall 13 to 18
Each Town Hall takes 7 to 12 days and each hero gains 5 or 10 levels per Town Hall, so hero and research time decide when a level is done. Before upgrading again, look at your research queue: if it is long, a new Town Hall widens the gap between your buildings and your army. Research what your main war attack uses first.
At Town Hall 18, the new pieces are the Revenge Tower and the Super Wizard Towers, the Laboratory goes to level 16, and the King and Queen to 110. Start the Laboratory and the heroes, then build the two new defences.
