Modding: Publishing mods to Steam Workshop

From Noita Wiki
Jump to navigation Jump to search
Modding Navigation
BasicsData.wakGetting startedLua ScriptingUseful Tools
AudioEnemiesEnvironments (Fog of War) • Image EmittersMaterialsPerksSpellsSteam WorkshopSpritesheetsUsing CMake
Component DocumentationEnumsList of all tagsSpecial Tags
Lua Scripting
Lua APIUtility Scripts
Other Information
Enemy Information TableMagic NumbersSound EventsSpell IDsPerk IDsMaterial IDs

Publishing mods in Steam Workshop needs the Steam version of Noita.


1. The mod's folder should exist inside Noita\mods\

2. Create a file called workshop.xml inside the mod's folder with the following contents:



  • YOUR_MOD_NAME_HERE and YOUR_MOD_DESCRIPTION_HERE are replaced with the name and description of your mod. You can use empty description in case you'd rather set the description through the mod's Steam workshop page (the description is not updated if the field is empty).
  • TAGS is a comma-separated list of tags applying to the mod.

Currently the following tags are available:

  • gameplay
  • graphics
  • quality of life
  • translations
  • perks
  • spells
  • player characters
  • loadouts
  • biomes
  • total conversions
  • game modes
  • creatures
  • bosses
  • alchemy
  • tweaks
  • items
  • audio
  • cheats
  • funny
  • streaming integration
  • mod dependencies

Tag names must be spelled exactly as above, in lowercase. Feel free to tell us if you feel a tag is missing.

  • FOLDER_IGNORE1 and so on are folders that shouldn't be uploaded separated with | (For example: dont_upload_folders="ignore_this|files\ignore_this_subfolder").
  • FILE_IGNORE1 and so on are files that shouldn't be uploaded separated with | (For example: dont_upload_folders="secret_dev_file.txt").

3. Create a file called workshop_preview_image.png inside the mod's folder. This file will be used as the mod's preview image in Steam Workshop. The image should have 16:9 aspect ratio.


  • Mods that have request_no_api_restrictions="1" don't work through Steam Workshop.
  • Only the following file types are uploaded:
    • .txt
    • .csv
    • .bmp
    • .xml
    • .png
    • .lua
    • .frag
    • .vert
    • .bank
    • .bin
  • Git folders (.git) are ignored automatically.
  • If you remove your mod from Steam Workshop and upload it again later, workshop_id.txt has to be first removed from the mod folder. "Steam - workshop upload failed: 2" might be an indicator of this.

Uploading using the upload wizard

  1. Make sure you're logged into your Steam account.
  2. Navigate into your Noita directory using a command line.
  3. Run the following command (or use workshop_upload.bat shipped with the game):
noita_dev.exe -workshop_upload

Batch upload

  1. Make sure you're logged into your Steam account.
  2. Navigate into your Noita directory using a command line.
  3. Run the following command:
noita_dev.exe -workshop_upload MOD_NAME -workshop_upload_change_notes CHANGE_NOTES

where MOD_NAME is the name of the mod folder inside the mods/ folder, for example nightmare

and where CHANGE_NOTES is the update's change notes or empty.

This allows uploading mods without any interrupts from the uploader UI.