Modding of Isaac Wiki:Adding Mods

From Modding of Isaac Wiki
Jump to navigation Jump to search
Warning-red.svg

All Isaac mods in the main space on this wiki must be officially released on the Workshop. Any information in wiki main space regarding any Isaac mods not on the Workshop will be removed. If you're unreleased, please use the unreleased mods tab!


If you are wanting to add a mod, please commit to it. Any released mods incompletely documented on the wiki, i.e., not worked on in one month, will be removed.

This page outlines how to add a new mod to the Official Modding of Isaac Wiki.

The process is slightly different depending on whether your mod is officially released. If it is not, you must work on it in your user space. Please select the correct tab for your mod before proceeding:

  • First, create an account, or if you are already registered, log in.
  • Create a new page in the main space that will serve as the main page and landing page for your mod:
Make sure to use the exact name that is displayed on the Workshop, in order to facilitate easily finding the mod.
  • Enter some basic information about the mod and save the page. You can take other mods' main pages as inspiration.
Ignore the warning that appears when saving the page.

All pages dealing with content of your mod have to be subpages of your mod main page. For example, if your mod main page was Forgotten Fables, then the page for your mod's items would be Forgotten Fables/Items. You can use this box to create new pages for your mod:

Make sure every article for the mod has the following text as the first line: {{mod sub-page}}<!--DO NOT REMOVE THIS LINE! It is required for Mod sub-pages to work properly.-->. It enables functionalities that are crucial for the correct functioning of the page.

Category pages, files (images, videos, music, etc.), and templates are to be named in the following format (assuming your mod main page is Forgotten Fables):

Categories Category:<name of your mod>/<category name>
Category:Forgotten Fables/Items
Files File:<file name> (<name of your mod>)
File:Blood Imbrem (Forgotten Fables).png
Logo File:Logo (<name of your mod>).png
File:Logo (Forgotten Fables).png
Templates Template:<name of your mod>/<template name>
Template:Forgotten Fables/EvilCounter
The mod's logo will be displayed in the upper right on every article.

  • First, create an account, or if you are already registered, log in.
  • Create a new page in your user space that will serve as the main page and landing page for your mod:
  • Enter some basic information about the mod and save the page. You can take other mods' main pages as inspiration.

All pages dealing with content of your mod have to be subpages of your mod main page. For example, if your mod main page was User:3.21.104.183/Forgotten Fables, then the page for your mod's items would be User:3.21.104.183/Forgotten Fables/Items. You can use this box to create new pages for your mod:

Make sure every article for the mod has the following text as the first line: {{mod sub-page}}<!--DO NOT REMOVE THIS LINE! It is required for Mod sub-pages to work properly.-->. It enables functionalities that are crucial for the correct functioning of the page.

Category pages, files (images, videos, music, etc.), and templates are to be named in the following format (assuming your mod main page is User:3.21.104.183/Forgotten Fables):

Categories Category:<name of your mod>/<category name>
Category:User:3.21.104.183/Forgotten Fables/Items
Files File:<file name> (<name of your mod>)
File:Blood Imbrem (User-3.21.104.183-Forgotten Fables).png
Logo File:Logo (<name of your mod>).png
File:Logo (User-3.21.104.183-Forgotten Fables).png
Templates Template:<name of your mod>/<template name>
Template:User:3.21.104.183/Forgotten Fables/EvilCounter
The mod's logo will be displayed in the upper right on every article.

If you need any help or have questions, please post on the Community/Admin noticeboard, contact AndreDoruk, or ask in the MoI servers MoI Wiki thread in the Hub channel.