Now showing on Modrinth: A new look!

After months of relatively quiet development, Modrinth has released many new features and improvements, including a redesign.

After months of relatively quiet development, Modrinth has released many new features and improvements, including a redesign. While we've been a bit silent recently on the website and blog, our Discord server has activity on the daily. Join us there and follow along with the development channels for the very latest information!

For both those who aren't in the Discord and for those who are, this serves as a status update for what exactly has been going on in our silence. There have been an unparalleled amount of changes, improvements, bug fixes, and new features being worked on since April 2021, and we are incredibly excited to share them with everyone. There are still many things we're still working on, such as modpacks, but we've decided to hold back on that as there is still some fine-tuning that needs to be done on that front.

New and improved design

The frontend has received a considerable facelift. With designs made in part by falseresync (and a sprinkle of bikeshedding), we present to you, the redesign!

As they say, a picture tells somewhere around nine-hundred odd words. As such, this section will be heavily focused on screenshots of the pages rather than long descriptions.

Project pages

On project pages, much of the focus has been shifted to the extended description rather than the metadata, which has been put over on the side. We've also added an option to switch this from the left side to the right side in your user settings, if you so desire.


Developers can now add a Gallery section on each project page! Each uploaded image or GIF can have a title and description associated with them.


Version changelogs are automatically compiled together into a large changelog list. These are put in reverse chronological order, and are separated for Fabric and Forge versions.

Version creation and dependencies

A look at the new version creation screen

Version creation has gotten an overhaul!

While dependencies have existed in the backend for a while, their implementation was a bit haphazard and was never widely used due to never being in the frontend. Thus, all previous dependencies have been wiped, and they have been redone better(TM). And hey, now you can add and see dependencies in the frontend!

Profile settings and dashboard

The dashboard has been reworked and reorganized: the "My mods" section has been merged into the profile page itself, and the "Settings" page has been split into "Profile" and "Security". There are also options for switching the project and search information from the left side of the screen to the right.

A screenshot of jellysquid3's user page

The notifications page is also now its own page separate from the dashboard, accessible only from the header. The notifications page also has a highly-requested "Clear all" button.

A screenshot of the notifications page

Backend changes and API v2

There have been a number of breaking changes in this update, and as such, the API number has been bumped. The /api/ prefix has also been removed, as it's redundant when the base API URL is This means the production URL is now instead of

The major changes include the universal rename of mod to project, as well as the move of the mod endpoint to search. While version 1 won't be removed until January 2023, we still highly recommend that applications migrate as soon as possible. For full migration instructions, see the migration guide on the docs site.


Minotaur is the tool for mod developers to upload their mod directly to Modrinth automated through Gradle. Minotaur received a considerable facelift and is now a lot more user-friendly. A before and after example is provided on this gist.

Notice how it's now in a modrinth {...} block instead of creating a new task. The modrinth task is now automatically created.

The loaders declaration in the new version isn't even needed if you're using Loom or ForgeGradle. The project version can be detected automatically, and the token uses the MODRINTH_TOKEN environment variable by default now. The game version and loader listings actually make sense now, and dependencies are possible!

More miscellanea

Along with the major headlining features, there are also a number of smaller features, fixes, and improvements coming with the big update. Most of these need no more than a bullet to describe, so here's a bullet list of the smaller things!

  • If you are the owner of a project, you can now transfer the ownership to another user, as long as they have already accepted an invitation to be a member. In the frontend, this can be done on the Settings page, under the "Team members" section.

  • iframes for YouTube videos are now allowed. Any iframes from elsewhere are still not allowed.

  • Files are now validated to ensure they contain a valid Forge or Fabric mod, or are in the correct modpack format.

  • When changing the status of a project, file moderators are now able to add a message (heading and body separate) to be seen by project team members.

  • Versions must now always have a file attached.

  • Projects will only be able to leave draft status if they contain at least one version. Additionally, a new archived status has been added.

  • Donation URLs have been re-enabled.

  • Fix: Markdown checkboxes will no longer render strangely (knossos#291)

  • Fix: Maven will no longer randomly break (labrinth#264 and labrinth#252)

  • ...and many other smaller things!

What happened to modpacks?

We've been teasing modpacks for a long time now. While they're done for the most part, we've decided to hold back on their release for the time being. We're working hard to get those done some time soon, and there'll be another post when those are ready for general consumption.

Conclusion and a call for developers

In conclusion, we hope that you're excited about this update as much as we are. We believe that, with how much work has been put into this update, it has definitely been worth the wait.

Thank you for reading, and may your dreams be filled with pineapples, tiny potatoes, and squirrels.