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
0
CurseForge ID
360673
Modrinth Downloads
0
Modrinth ID
RGH5gtzF
Last Updated
Apr 13, 2026
Description
Installation
The mod supports NeoForge and Fabric (*) mod loaders. Follow either mod loader's installation guide, then download the mod file 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 <version>. 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:
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:mod_id} - version of installed mod with the identifier mod_id
- {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 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:
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:
title = "Minecraft {mcversion} - Custom Window Title {modversion:customwindowtitle}"

Screenshots
Similar Mods
Cleaner Tooltips
A simple client-side mod that changes the tooltips of tools and armor to display their attributes as icons.
PartialHearts
Exact health displayed with fractions of a heart.
Epic Structures: Dungeons
Adds dungeons of various rarities and sizes
TAB
TAB is an all-in-one plugin for displaying information in various places
[Reforged] Accurate Block Placement
makes placing blocks a smooth and reliable process when holding right click.
Compat Structure
Adds structures to popular mods. Create, Alex's Caves, Ice and Fire and etc.
Included in Modpacks
PURE.
EdonMe Survival
Better OneBlock
Better fps than vanilla and optifine