What is discord.js?

discordjs/discord.js — explained in plain English

Analysis updated 2026-05-18

★ 26,695TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((discord.js))
    What it does
      Build Discord bots
      Handle messages and commands
      Manage roles and permissions
      Play voice audio
    Key features
      Slash commands
      Button interactions
      Event listeners
      Message handling
    Use cases
      Server moderation
      Custom commands
      Music bots
      Community games
    Tech stack
      JavaScript
      Node.js
      TypeScript
    Getting started
      Official guide
      Scaffolding tool
      Active community

mindmap root((discord.js)) What it does Build Discord bots Handle messages and commands Manage roles and permissions Play voice audio Key features Slash commands Button interactions Event listeners Message handling Use cases Server moderation Custom commands Music bots Community games Tech stack JavaScript Node.js TypeScript Getting started Official guide Scaffolding tool Active community

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Build a moderation bot that automatically removes spam and enforces server rules.

USE CASE 2

Create a music bot that plays songs in voice channels when users request them.

USE CASE 3

Add custom slash commands to your server for games, polls, or utility functions.

USE CASE 4

Set up automated welcome messages and role assignment when new members join.

What is it built with?

TypeScriptJavaScriptNode.js

How does it compare?

	discordjs/discord.js	marmelab/react-admin	langfuse/langfuse
Stars	26,695	26,682	26,674
Language	TypeScript	TypeScript	TypeScript
Setup difficulty	easy	moderate	moderate
Complexity	2/5	3/5	3/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Use freely for any purpose including commercial. Keep the notice and disclose changes to the patent grant.

So what is it?

Discord.js is the most popular JavaScript library for building Discord bots, automated programs that live inside Discord servers and respond to messages, slash commands, button clicks, and other events. It's the tool developers reach for when they want to add a bot to their community server. Think of Discord.js as a translator layer: Discord has a complex API (a way for software to talk to Discord's servers), and discord.js wraps all that complexity into simple, readable code. Instead of dealing with raw API calls, a developer can write plain JavaScript that says things like "when someone types /help, send them a welcome message" and discord.js handles all the technical details of communicating with Discord in the background. The library covers everything Discord bots need: reading and sending messages, managing server roles and permissions, playing audio in voice channels, handling button and dropdown menu interactions, and reacting to any event happening in a server. There's also a companion tool that scaffolds a new bot project in seconds, giving you a working starting point without writing boilerplate from scratch. For a vibe coder or community builder, this is the standard starting point for adding automation, moderation, games, music, or custom commands to a Discord server. The project has extensive documentation, an official guide, and an active support community on Discord itself. Being JavaScript-based means it runs on Node.js (the server-side JavaScript runtime) and integrates naturally with the broader JavaScript ecosystem.

Copy-paste prompts

Prompt 1

Show me how to create a simple Discord bot using discord.js that responds to the /ping command.

Prompt 2

How do I set up discord.js to listen for button clicks and send different messages based on which button was pressed?

Prompt 3

Write a discord.js bot that automatically assigns a role to new members when they join the server.

Prompt 4

How do I use discord.js to play audio in a voice channel when a user types a command?

Prompt 5

Show me the basic structure of a discord.js bot project and how to handle message events.

Frequently asked questions