Modrinth

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

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

Downloads (branded)
Followers
Version
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)