Custom Window Title
Modby chylex
Client-side mod to change window title (including special tokens) and window icon. Supports Forge & Fabric.
Type
Mod
CurseForge Downloads
4,431,660
CurseForge ID
360673
Modrinth Downloads
711,400
Modrinth ID
RGH5gtzF
Last Updated
Jul 27, 2026
Description
## Installation
The mod supports [NeoForge](https://neoforged.net/) and [Fabric](https://fabricmc.net/) (*) mod loaders. Follow either mod loader's installation guide, then [download the mod file](https://modrinth.com/mod/custom-window-title/versions) for your Minecraft version, and install it into the `.minecraft/mods` folder.
(*) Fabric API is **not** required.
## Configuration
Run the game once to create the configuration file. By default, the window title will be set to **Minecraft __**. Unlike in vanilla 1.15.2 onwards, the title will not change when you enter a world/server.
To change the title or icon, navigate to the `.minecraft/config` folder, and open `customwindowtitle-client.toml` in a text editor. You will see the following entries:
```toml
title = 'Minecraft {mcversion}'
icon16 = ''
icon32 = ''
```
Only edit text inside quotes or apostrophes.
### Changing the Title
You can use the following special tokens in the _title_ configuration entry:
* `{mcversion}` - current Minecraft version
* `{modversion:}` - version of installed mod with the identifier ``
* `{username}` - current username
If any of the tokens aren't working, search the game log for **CustomWindowTitle** and you should see the reason, otherwise please file an issue on the [issue tracker](https://github.com/chylex/Minecraft-Window-Title/issues) with as many details as possible.
### Changing the Icon
#### Minecraft 1.21+
**This feature is only available in Custom Window Title 1.4.0 and newer.**
Create a square PNG image whose dimensions are a power of two, such as 32x32 or 48x48. Put the PNG file into the `.minecraft/config` folder, either directly or into a subfolder.
The icon **must be saved with transparency** even if it doesn't use it, otherwise the icon may be corrupted or not appear at all. In Krita, for example, you must check _Store alpha channel (transparency)_ when saving.
The _icon_ configuration entry points to the PNG file relative to `.minecraft/config`.
For example, if you placed the icon into `.minecraft/config/customwindowtitle/icon.png`, then the configuration entry should look like this:
```toml
icon = 'customwindowtitle/icon.png'
```
#### Minecraft 1.20
This feature is not available in Minecraft 1.20.
#### Minecraft 1.19 and older
Instead of one `icon` configuration entry, there are two configuration entries `icon16` and `icon32` for icons with dimensions 16x16 and 32x32.
## Screenshots
These screenshots were taken using the following example configuration:
```toml
title = "Minecraft {mcversion} - Custom Window Title {modversion:customwindowtitle}"
```


Compatibility
Mod Loaders
Fabric
Forge
Neoforge
Game Versions
1.8.9
1.9.4
1.10.2
1.11.2
1.12.2
1.14
1.14.1
1.14.2
1.14.3
1.14.4
+36 more
Screenshots
Similar Mods
Botany Trees
Allows you to grow trees in small pots.
Mod
51,304,253
Clean Swing Through Grass
Hit your Enemies even in Grass
Mod
51,201,994
Snow Under Trees
Adds snow under trees in snowy biomes
Mod
51,133,977
Decocraft
Decorate your minecraft world with epic models, choose from over 3.000 objects! More are added every week!
Mod
51,121,710
Shutup Experimental Settings!
Removes the Experimental Settings prompt before world creation.
Mod
51,121,472
Shulker Box Tooltip [Fabric/Forge/NeoForge]
What's in my shulker box?
Mod
51,041,095
Included in Modpacks
PURE.
EdonMe Survival
Better OneBlock
Better fps than vanilla and optifine
RothCraft
uhpvp
Scurz PvP
Connect Client
ZoeyNeko's Create Modpack
Reign of Nether: Better Edition
Mr Wildfire's Modpack
Better Create
简约生电优化 Simplicity Survival Optimization
Caerott Challenges
Vanilla Bloom