Modrinth

Badges for Modrinth — downloads, followers, version, game versions.

Display mod stats from Modrinth, the modern Minecraft mod platform.

modrinth downloads
Downloads (branded)
modrinth followers
Followers
modrinth version
Version
modrinth game versions
Game versions

Available badges

BadgeEndpointDescription
Downloads/modrinth/downloads/{slug}Total download count
Followers/modrinth/followers/{slug}Follower count
Version/modrinth/v/{slug}Latest version
Game Versions/modrinth/game-versions/{slug}Supported Minecraft versions

Quick examples

![downloads](https://shieldcn.dev/modrinth/downloads/sodium.svg)
![version](https://shieldcn.dev/modrinth/v/fabric-api.svg?variant=branded)

Data source

Uses the Modrinth API v2. No API key required. Cached 1 hour.

Endpoint details

Use these sections when you need the exact URL shape or a focused example for a specific badge type.

Modrinth Downloads

This section covers the modrinth/downloads badge endpoint.

Show total downloads for a Modrinth mod or modpack.

GET/modrinth/downloads/:slug.svg

Path Parameters

required
![badge](https://shieldcn.dev/modrinth/downloads/sodium.svg)
badge preview

URL format

/modrinth/downloads/{slug}.svg

Copy-paste examples

Default — total download count

![downloads](https://shieldcn.dev/modrinth/downloads/sodium.svg)

Branded — Modrinth green

![downloads](https://shieldcn.dev/modrinth/downloads/sodium.svg?variant=branded)

Modrinth Followers

This section covers the modrinth/followers badge endpoint.

Show the follower count for a Modrinth project.

GET/modrinth/followers/:slug.svg

Path Parameters

required
![badge](https://shieldcn.dev/modrinth/followers/sodium.svg)
badge preview

URL format

/modrinth/followers/{slug}.svg

Copy-paste examples

Default — follower count

![followers](https://shieldcn.dev/modrinth/followers/sodium.svg)

Branded — Modrinth green

![followers](https://shieldcn.dev/modrinth/followers/sodium.svg?variant=branded)

Modrinth Game Versions

This section covers the modrinth/game-versions badge endpoint.

Show the range of supported Minecraft versions for a Modrinth project.

GET/modrinth/game-versions/:slug.svg

Path Parameters

required
![badge](https://shieldcn.dev/modrinth/game-versions/sodium.svg)
badge preview

URL format

/modrinth/game-versions/{slug}.svg

Copy-paste examples

Default — supported Minecraft version range

![game versions](https://shieldcn.dev/modrinth/game-versions/sodium.svg)

Branded — Modrinth green

![game versions](https://shieldcn.dev/modrinth/game-versions/sodium.svg?variant=branded)

Modrinth Version

This section covers the modrinth/version badge endpoint.

Show the latest published version for a Modrinth project.

GET/modrinth/v/:slug.svg

Path Parameters

required
![badge](https://shieldcn.dev/modrinth/v/sodium.svg)
badge preview

URL format

/modrinth/v/{slug}.svg

Copy-paste examples

Default — latest version number

![version](https://shieldcn.dev/modrinth/v/sodium.svg)

Branded — Modrinth green

![version](https://shieldcn.dev/modrinth/v/fabric-api.svg?variant=branded)