Overview

This release primarily adds support for file uploads in modals.

Creating a Modal accepting file uploads

Modal.create("modal-id", "Banner Update")
  .addComponents(Label.of("Banner Image", AttachmentUpload.of("banner-file")))
  .build()

Using the uploaded file

@Override
public void onModalInteraction(@NotNull ModalInteractionEvent event) {
    event.reply("The banner is being updated.").setEphemeral(true).queue();
    
    Message.Attachment attachment = event.getValue("cat-img").getAsAttachmentList().get(0);
    attachment.getProxy()
        .downloadAsIcon()
        .thenCompose(icon -> event.getGuild().getSelfMember().getManager().setBanner(icon).submit())
        .exceptionally(e -> {
            RestAction.getDefaultFailure().accept(e);
            return null;
        });
}

New Features

• Add modal file uploads by @freya022 in #2920
• Support modifying avatar, banner and bio of current member by @freya022 in #2915
• Add missing Invite.Guild fields by @freya022 in #2914

Full Changelog: v6.0.0...v6.1.0

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:6.1.0")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>6.1.0</version> 
</dependency>

Overview

This is the stable release of JDA 6.0.0. To avoid repeating the same information again, please look at the release notes of the release candidates for detailed explanations of the breaking changes and new features.

Release Candidates

1. v6.0.0-rc.1 New Components
2. v6.0.0-rc.2 New Pin Pagination API
3. v6.0.0-rc.3 New pin permissions and removal of bot owned guilds
4. v6.0.0-rc.4 Change to Modals
5. v6.0.0-rc.5 Modal Components and Serialization

Migrating to 6.0.0

To help ease the upgrade to JDA 6.0.0, we've provided an OpenRewrite recipe that can automatically refactor parts of your codebase. This will update imports and replace a few method calls with their new equivalents in JDA 6.0.0.

However, not all breaking changes can be handled automatically — for example, code that relied on the mutability of ActionRow will require manual adjustments.

You will also have to update your code for creating Modal instances. Instead of using ActionRow, modals now make use of the Label component. Read the release notes for v6.0.0-rc.4 to learn more.

The OpenRewrite Recipe

Before applying the recipe, make sure you’re using version control (e.g., Git) or back up your project manually. You’ll also need to be using Gradle or Maven to apply the migration.

plugins {
    id("org.openrewrite.rewrite") version "7.11.0"
}

repositories {
    mavenCentral()
}

dependencies {
    // Your current JDA version before upgrading to 6.0.0
    implementation("net.dv8tion:JDA:5.+")

    rewrite("net.dv8tion:JDA:6.0.0")
    rewrite("org.openrewrite.recipe:rewrite-java-dependencies:1.37.0")
}

rewrite {
    activeRecipe("net.dv8tion.MigrateComponentsV2")
}

<plugin>
  <groupId>org.openrewrite.maven</groupId>
  <artifactId>rewrite-maven-plugin</artifactId>
  <version>6.13.0</version>
  <configuration>
    <activeRecipes>
      <recipe>net.dv8tion.MigrateComponentsV2</recipe>
    </activeRecipes>
  </configuration>
  <dependencies>
    <dependency>
      <groupId>org.openrewrite.recipe</groupId>
      <artifactId>rewrite-java-dependencies</artifactId>
      <version>1.37.0</version>
    </dependency>
    <dependency>
      <groupId>net.dv8tion</groupId>
      <artifactId>JDA</artifactId>
      <version>6.0.0</version>
    </dependency>
  </dependencies>
</plugin>

New Features

• Add support for components V2 by @freya022 in #2809
• Add new pinned message pagination by @MinnDevelopment in #2874
• Add message pin permission by @freya022 in #2895
• Add support for user primary guilds by @mjezek-dev in #2863
• Add common interface for interactions with a custom ID by @Kaktushose in #2778
• Add support for Label and StringSelectMenu in Modals by @Xirado in #2162
• Add ComponentSerializer and ComponentDeserializer by @MinnDevelopment in #2906
• Add TextInput#of shortcut by @MinnDevelopment in #2908
• Add entity selects and text displays in modals by @freya022 in #2913

Changes

• Remove deprecated features by @MinnDevelopment in #2867
• Make JDA#getMutualGuilds accept UserSnowflake instead of User objects by @MineKing9534 in #2877
• Move modal classes out of the interactions package by @freya022 in #2890
• Use new routes to (un)pin messages by @freya022 in #2896
• Remove bot owned guild endpoints by @freya022 in #2888

Bug Fixes

• Remove port stripping in VoiceServerUpdateHandler by @MinnDevelopment in #2884
• Use DELETE_GUILD route according to the Discord Docs by @kiLeo13 in #2875
• Handle forum channels with missing available_tags field by @MinnDevelopment in #2902
• Remove unnecessary escaping while creating a masked link by @Alf-Melmac in #2910

Full Changelog: v5.6.1...v6.0.0

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:6.0.0")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>6.0.0</version> 
</dependency>

Overview

This release adds support for more components in Modals and reintroduces serialization for all components.

Modal Components (#2913)

In the previous release, support for StringSelectMenu within modals has been added. This is now expanded to also include EntitySelectMenu and TextDisplay components.

The TextDisplay component has full markdown support, which allows you to create more fleshed out modals than before:

Modal.create("modal", "Role Request Form")
    .addComponents(
        TextDisplay.of("""
            **Welcome!**
            
            Please read the following before continuing:
            
            - Select a user to request a role for
            - A moderator will review your request
            - Abuse of this system may result in penalties
            """),
        Label.of(
            "Role",
            EntitySelectMenu.create("role-select", SelectTarget.ROLE).build()
        )
    )
    .build();

Results in this modal being shown:

Serialization and Deserialization (#2906)

We've added a new ComponentSerializer and ComponentDeserializer, which can be used to serialize components into DataObject and FileUpload instances. This replaces the previous component.toData() from JDA 5, with a new serializer.serialize(component).

Example:

ComponentSerializer serializer = new ComponentSerializer();

List<DataObject> serializedComponents = serializer.serializeAll(message.getComponents());
List<FileUpload> files = serializer.getFileUploads(message.getComponents());

// use serialized component
// ...

// Or deserialize them if you get them from another source
// Here we pass in the List<FileUpload> used by the components
ComponentDeserializer deserializer = new ComponentDeserializer(files);
MessageComponentTree tree = deserializer.deserializeAsTree(MessageComponentTree.class, serializedComponents);

New Features

• Add ComponentSerializer and ComponentDeserializer by @MinnDevelopment in #2906
• Add TextInput#of shortcut by @MinnDevelopment in #2908
• Add StringSelectMenu.Builder#isRequired() by @freya022 in #2911
• Add entity selects and text displays in modals by @freya022 in #2913

Changes

• Deprecate and replace TextInput.Builder#setId with setCustomId by @freya022 in #2909

Bug Fixes

• Remove unnecessary escaping while creating a masked link by @Alf-Melmac in #2910

Full Changelog: v6.0.0-rc.4...v6.0.0-rc.5

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:6.0.0-rc.5")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>6.0.0-rc.5</version> 
</dependency>

Overview

This release primarily introduces breaking changes to Modals. Discord has finally added support for StringSelectMenu in Modals, which comes with a minor breaking change in how Modals are created.

Breaking Changes

With the update to Modals, we removed legacy functionality around ActionRow in Modal. Instead of using ActionRow.of(...), modals make use of the new Label components instead.

Before:

Modal.create("modal", "My Modal")
    .addComponents(
      ActionRow.of(TextInput.create("input", "My Custom Label", TextInputStyle.SHORT).build()))
    .build();

After:

Modal.create("modal", "My Modal")
    .addComponents(
      Label.of("My Custom Label", TextInput.create("input", TextInputStyle.SHORT).build()))
    .build();

With this update, you can now also use StringSelectMenu in Modals, which can also be added using the Label component.

Label.of("My Custom Label",
    StringSelectMenu.create("menu-custom-id")
        .addOption("My option", "option-1")
        .build())

When a user submits a modal with a select menu, the values are available in the ModalInteractionEvent using getValue("menu-custom-id").getAsStringList().

New Features

• Add support for Label and StringSelectMenu in Modals by @Xirado in #2162

Bug Fixes

• Serialize unique id for text inputs by @MineKing9534 in #2899
• Handle forum channels with missing available_tags field by @MinnDevelopment in #2902

Full Changelog: v6.0.0-rc.3...v6.0.0-rc.4

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:6.0.0-rc.4")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>6.0.0-rc.4</version> 
</dependency>

Overview

Another release candidate for JDA 6.0.0 with some more minor breaking changes. Modal features have been moved to a new package and functionality to bot owned guilds has been removed, including Guild#delete, Guild#transferOwnership, JDA#createGuild, and GuildManager#setMFALevel.

This release candidate also includes some underlying API changes and bug fixes that are backwards compatible, as well as some minor feature additions.

Breaking Changes

Some of these changes have been integrated into the 6.0.0 OpenRewrite recipe, please re-apply it if necessary. See the release notes for 6.0.0-rc.1 for details.

• Move modal classes out of the interactions package by @freya022 in #2890
• Remove bot owned guild endpoints by @freya022 in #2888

New Features

• Add message pin permission by @freya022 in #2895
• Add support for user primary guilds by @mjezek-dev in #2863
• Add common interface for interactions with a custom ID by @Kaktushose in #2778

Other Changes

• Use new routes to (un)pin messages by @freya022 in #2896

Bug Fixes

• Remove port stripping in VoiceServerUpdateHandler by @MinnDevelopment in #2884
• Several Components V2 changes by @freya022 in #2881

Full Changelog: v6.0.0-rc.2...v6.0.0-rc.3

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:6.0.0-rc.3")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>6.0.0-rc.3</version> 
</dependency>

Overview

This release includes a minor breaking change to the retrievePinnedMessages method.

Originally, this method could only fetch up to 50 pinned messages. However, the underlying endpoint has been deprecated and replaced with a new paginated endpoint, as detailed in the Discord Changelog.

We have updated our API to utilize a PaginationAction. The callback response is now a list of PinnedMessage objects instead of a list of messages. Each PinnedMessage instance contains the timestamp when the message was pinned and the pinned message object. With this pagination action, the retrieval of pinned messages is no longer limited to 50 messages and can now fetch more, for instance by using takeAsync(200).

To replicate the previous behavior (retrieving only up to 50 pinned messages), you can use queue() as before, but you will need to map the list to a List<Message> as follows:

channel.retrievePinnedMessages()
  .map(list -> list.stream().map(PinnedMessage::getMessage).toList())
  .queue(list -> ...);

Changes

• Make JDA#getMutualGuilds accept UserSnowflake instead of User objects by @MineKing9534 in #2877
• Add new pinned message pagination by @MinnDevelopment in #2874

Full Changelog: v6.0.0-rc.1...v6.0.0-rc.2

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:6.0.0-rc.2")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>6.0.0-rc.2</version> 
</dependency>

Overview

This version introduces support for Components Version 2, a significant update to Discord's component system. To accommodate this new API, we’ve made a number of key changes to our component implementation:

• All components are now immutable
  Previously, ActionRow allowed modification of its contained components. To simplify and modernize the API, this mutability has been removed.

• New top-level component interfaces
  The LayoutComponent interface (previously only implemented by ActionRow) has been replaced by two new interfaces:
  - MessageTopLevelComponent
  - ModalTopLevelComponent
  This change reflects the increased flexibility introduced in Components V2, where top-level components are no longer restricted to layout containers like ActionRow. Components such as TextDisplay and FileDisplay can now appear directly at the top level.

• Renamed getId → getCustomId
  The original getId method has been renamed to getCustomId to avoid confusion with Discord's new getUniqueId, which is a numeric, auto-generated identifier.

• Temporary removal of toData for components
  Some components now require attachments to function properly, complicating serialization. We’ve removed the toData method for now and are working on a new, more capable serialization API that will be introduced in a later update.

Big thanks to @freya022 and @DV8FromTheWorld for contributing on this giant feature!

Using Components V2

To use the new components introduced in this release, you must enable the Components V2 feature flag on your message request. This can be done using the useComponentsV2 method on MessageRequest.

To get started, check out the new ComponentsV2Example to explore the possibilities of this updated API. You can also see it in action in a demo project by @DV8FromTheWorld: discord-pokedex.

New Components

JDA 6 introduces several new component types as part of the Components V2 system:

• Container
  Displays components inside a visually distinct box — similar to how embeds are styled.

• Thumbnail
  Shows a small image next to text. Commonly used as an accessory within a Section component.

• FileDisplay
  Displays a file attachment as a downloadable item. For visual file content (e.g., images), consider using MediaGallery instead.

• MediaGallery
  Shows multiple images in a gallery layout — similar to a list of image attachments in Discord.

• Section
  Displays a block of text content with optional accessories like thumbnails or buttons.

• Separator
  Adds vertical spacing between components, helping visually organize content.

• TextDisplay
  A simple text component used to display content without relying on the content field of a message.

New Utilities For Components

Several new utilities have been added to simplify working with complex component structures — including traversal, replacement, and deserialization:

• MessageComponentTree & ModalComponentTree
  A single object that provides the functionality to iterate and replace components easily.

• ComponentReplacer
  An interface for removing or replacing components within a tree or collection.
  For example, remove a component by unique ID using byUniqueId(1, null).

• ComponentIterator & ComponentPathIterator
  Tools for recursively iterating through nested components, including child elements like buttons within an ActionRow.

• Components
  A utility class used for parsing serialized JSON into JDA's component model.

Migrating To 6.0.0

To help ease the upgrade to JDA 6.0.0, we've provided an OpenRewrite recipe that can automatically refactor parts of your codebase. This will update imports and replace a few method calls with their new equivalents in JDA 6.0.0.

However, not all breaking changes can be handled automatically — for example, code that relied on the mutability of ActionRow will require manual adjustments.

The OpenRewrite Recipe

Before applying the recipe, make sure you’re using version control (e.g., Git) or back up your project manually. You’ll also need to be using Gradle or Maven to apply the migration.

plugins {
    id("org.openrewrite.rewrite") version "7.11.0"
}

repositories {
    mavenCentral()
}

dependencies {
    // Your current JDA version before upgrading to 6.0.0
    implementation("net.dv8tion:JDA:5.+")

    // The current 6.0.0 release version
    rewrite("net.dv8tion:JDA:6.0.0-rc.1")
    rewrite("org.openrewrite.recipe:rewrite-java-dependencies:1.37.0")
}

rewrite {
    activeRecipe("net.dv8tion.MigrateComponentsV2")
}

<plugin>
  <groupId>org.openrewrite.maven</groupId>
  <artifactId>rewrite-maven-plugin</artifactId>
  <version>6.13.0</version>
  <configuration>
    <activeRecipes>
      <recipe>net.dv8tion.MigrateComponentsV2</recipe>
    </activeRecipes>
  </configuration>
  <dependencies>
    <dependency>
      <groupId>org.openrewrite.recipe</groupId>
      <artifactId>rewrite-java-dependencies</artifactId>
      <version>1.37.0</version>
    </dependency>
    <dependency>
      <groupId>net.dv8tion</groupId>
      <artifactId>JDA</artifactId>
      <version>6.0.0-rc.1</version>
    </dependency>
  </dependencies>
</plugin>

The ComponentReplacer

If you previously used LayoutComponent.updateComponents or changed an action row with the mutable getComponents(), you will have to migrate your code to the new ComponentReplacer instead.

Before:

List<LayoutComponent> components = message.getComponents();

LayoutComponent.updateComponent(
    components,
    "my-component-id",
    Button.primary("button-id", "Click me").asDisabled()
);

After:

MessageComponentTree components = message.getComponentTree();
...

Bug Fixes

• Remove check for isWebhookMessage in checkUser by @MinnDevelopment in #2857

Full Changelog: v5.6.0...v5.6.1

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.6.1")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.6.1</version> 
</dependency>

Overview

This release introduces the ApplicationManager, which can be used to update the application's description and other settings through JDA.

New Features

• Implement application manager by @MinnDevelopment and @raul1ro in #2854
• Require a UserSnowflake in moveVoiceMember and kickVoiceMember by @freya022 in #2852

Changes

• Add with_components=true query param to WebhookClient requests by @Xirado in #2850
• Set thread ID when manipulating message objects made by webhooks by @freya022 in #2849

Bug Fixes

• Fix message content intent warning being logged when accessing messag… by @Xirado in #2851
• Handle new voice websocket close codes by @MinnDevelopment in #2855

Full Changelog: v5.5.1...v5.6.0

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.6.0")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.6.0</version> 
</dependency>

Overview

This is a small release, including a bug fix for editCommand and editCommandById, as well as some performance improvements for looking up members by roles.

Additionally, you can now create threads with a custom slowmode.

New Features

• Add AbstractThreadCreateAction#setSlowmode by @replaceitem in #2842
• Add Member#getUnsortedRoles by @MinnDevelopment in #2841

Bug Fixes

• Fix editCommandById by @MinnDevelopment in #2839

Full Changelog: v5.5.0...v5.5.1

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.5.1")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.5.1</version> 
</dependency>