Hearts of Iron IV doesn't use full nation names when running behind-the-scenes commands. Instead, the game relies on HOI4 country tags—three-letter identifiers like GER for Germany or SOV for the Soviet Union—to track every government, breakaway faction, and emerging state. If you're trying to switch nations mid-campaign, force an annexation, or test a mod, you need to know how these codes function.
Understanding these tags saves you from command errors and lets you manipulate game states with precision. Whether you're troubleshooting a bug or setting up an alternate history scenario, mastering three-letter country codes is essential for working with the game engine.
What Are Country Tags and Why Do They Matter?
Every nation in Hearts of Iron IV is assigned a unique, case-insensitive three-letter string in the game's code files. The game engine uses these abbreviations internally to process diplomacy, events, and player inputs. When you type commands into the developer console, the game doesn't recognize "Germany" or "United Kingdom"; it requires the exact string GER or ENG.
Major powers have intuitive tags, but minor nations and dynamic civil war splits can get confusing. For instance, the main German state is GER, while fascist or democratic splinter factions created during a civil war might receive temporary codes like D01 or specific breakaway tags depending on the focus tree. BBC has also covered this critical subject in extensive detail.
How to Find Any Country Tag in Your Game
You won't always memorize every minor nation's code, especially when running total conversion mods like Kaiserreich or The New Order, which introduce hundreds of custom tags. Fortunately, the game includes a built-in debugging tool to find them instantly.
- Open the developer console by pressing the tilde (
~) key on your keyboard. (Depending on your keyboard layout, this might beö,^, orShift + 3). - Type
tdebugand press Enter. This toggles the developer tooltip mode. - Hover your mouse cursor over any territory or unit belonging to the target nation.
- Look at the tooltip box that appears; it will display the country's three-letter tag alongside state IDs and strategic region data.
- Type
tdebuginto the console again to turn the debug overlay off.
This method works across vanilla versions and heavy mods, ensuring you never have to guess an abbreviation.
Essential Console Commands That Require Tags
Country tags are the backbone of most utility and cheat commands in single-player sessions. Without them, you can't target specific nations for manipulation. Here are the most common commands you'll use:
- Switching Countries: Typing
tag [country tag](such astag USA) instantly transfers your control to that nation, leaving your previous country to the AI. - Annexation: Typing
annex [country tag]immediately absorbs the specified nation and all its controlled states into your current country. - Releasing Nations: Typing
release [country tag]spins up a puppet state from your occupied or core territories based on historical releasable borders. - White Peace: Typing
whitepeace [country tag]forces an immediate cessation of hostilities and white peace between your current country and the target.
Keep in mind that opening the console and using these commands disables Ironman mode, meaning you won't earn Steam achievements during that session.
Standard Tags for Major Nations
While you can look up any nation on the fly, having the most common tags memorized speeds up testing and scenario setup. Major historical powers use these standard identifiers:
- Germany:
GER - Soviet Union:
SOV - United States:
USA - United Kingdom:
ENG - France:
FRA - Italy:
ITA - Japan:
JAP - China:
CHI
For official documentation on game mechanics, patches, and developer diaries, check the Paradox Interactive Forums. You can also explore community-driven documentation on the Hearts of Iron IV Wiki for deep dives into game files.
Common Mistakes When Using Tags
Players often run into frustrating roadblocks when typing commands because of small syntax errors. Avoid these frequent pitfalls to keep your game running smoothly:
- Forgetting to pause: If you switch tags using the
tagcommand while the game clock is running, the AI might make catastrophic changes to your former nation in a single unpaused second. Always pause before switching. - Using full names: Typing
annex Francewill result in an error message. The engine strictly requires the three-letter code (annex FRA). - Trying commands in Ironman: Console commands are hard-locked in Ironman mode. If the tilde key doesn't open a console box, you're likely in an Ironman save or running a configuration that blocks developer inputs.
- Mod tag conflicts: Total overhaul mods often overwrite vanilla tags or introduce new ones. Relying on a vanilla tag list while playing a major total conversion mod will lead to syntax errors or unexpected nation shifts.
Frequently Asked Questions
Do country tags change if a nation changes its ideology?
No. Germany remains GER whether it goes democratic, communist, fascist, or non-aligned. The three-letter identifier stays tied to the nation slot rather than its current government type, though cosmetic names and flags will update.
Can I use country tags in multiplayer lobbies?
Only if you are hosting a dedicated server or a local game with console access enabled for administrators. In standard public multiplayer matches, the console is locked entirely to prevent cheating.
Why does a country have a tag starting with 'D'?
Breakaway states, civil war factions, and dynamic countries created mid-game (such as the Spanish Civil War splinter tags) are often assigned dynamic codes like D01, D02, or specific revolt tags if they don't have a pre-programmed historical tag. Use tdebug to check their exact code before running commands.
Are country tags case-sensitive?
No. The game engine accepts both lowercase and uppercase inputs, so typing tag ger works just as well as tag GER. Uppercase is simply used out of convention to keep commands readable.
