Skip to content

Installing and Sharing

github-actions[bot] edited this page Oct 21, 2026 · 3 revisions

Installing and sharing

Install into TF2

Click Install (top right), choose a folder name and how to install it, then click Install to TF2:

  • Link (default): tf/custom/<folder name> points at your HUD folder (a junction on Windows, a symlink elsewhere). Nothing is copied, and every save is what TF2 loads.
  • Copy: the HUD is copied into tf/custom/<folder name>.

Either way:

  • if a folder with that name already exists, it's moved to the backups folder first, so nothing is lost;
  • your working copy stays where it is, so you can keep editing and installing again;
  • if your HUD already lives in tf/custom, TF2 loads it directly and you only need to save.

In TF2, restart the game, or run these in the console to reload most changes:

hud_reloadscheme

Some changes (new fonts, hudlayout.res, menus) need a full restart.

To keep several HUDs and switch between them, see HUD Library. To start TF2 and reload the HUD from the studio, see Testing in TF2.

Export a zip

Use Export .zip… in the same Install & share dialog to make a zip with one top-level folder. That's the layout people expect when they drop a HUD into tf/custom.

Before you share

  • Check Problems for errors.
  • Add an info.vdf with your HUD's name (the New HUD wizard creates one).
  • Include the licenses of any fonts you ship.
  • Don't ship Valve's files you didn't change. Overrides only need the parts you edited.

Clone this wiki locally