From a5806cfc5a715f9b2ebb9b2c2f32b0f1708eec98 Mon Sep 17 00:00:00 2001 From: Colin Loretz Date: Fri, 21 Nov 2025 17:56:01 +0000 Subject: [PATCH 1/6] permission split timeline --- .../2025-11-24-upcoming-permission-splits.md | 46 +++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 docs/change-log/2025-11-24-upcoming-permission-splits.md diff --git a/docs/change-log/2025-11-24-upcoming-permission-splits.md b/docs/change-log/2025-11-24-upcoming-permission-splits.md new file mode 100644 index 0000000000..08cc1ed7e5 --- /dev/null +++ b/docs/change-log/2025-11-24-upcoming-permission-splits.md @@ -0,0 +1,46 @@ +--- +title: "Permission Changes Going into Effect February 2026 for PIN_MESSAGES, BYPASS_SLOWMODE, CREATE_GUILD_EXPRESSIONS, and CREATE_EVENTS" +date: "2025-11-24" +breaking: true +--- + +We have some important permission changes that will take effect in February 2026. + +The introduction of the following permissions were non-breaking changes. + +However, the breaking changes described below - where the old permissions will no longer grant these abilities - will take effect on February 23, 2026. These changes involve a few permissions that we split from their original permission to provide more granular control over bot and user actions. + +### What's Changing? + +**1. Pin Messages Permission** + +- The `PIN_MESSAGES` permission (`1 << 51`) was split from `MANAGE_MESSAGES` on August 20, 2025. [Read the change log](/docs/change-log#pin-permission-split). +- Starting February 23, 2026, bots will need the `PIN_MESSAGES` permission to pin messages. `MANAGE_MESSAGES` alone will no longer be sufficient. + +**2. Bypass Slowmode Permission** + +- The `BYPASS_SLOWMODE` permission (`1 << 52`) is being split from `MANAGE_MESSAGES`, `MANAGE_CHANNEL` and `MANAGE_THREADS`. +- Note: This primarily affects users, as bots are not affected by slowmode restrictions. +- Starting on February 23, 2026, users will need the `BYPASS_SLOWMODE` permission to not be affected by slowmode restrictions. + +**3. Create Expressions Permission** + +- The `CREATE_GUILD_EXPRESSIONS` permission (`1 << 43`) was created in July 2023 and split from `MANAGE_GUILD_EXPRESSIONS` for users in December 2023. [Read the change log](/docs/change-log#clarification-on-permission-splits-for-expressions-and-events). +- As of today, bots now have access to the `CREATE_GUILD_EXPRESSIONS` permission. [Read the change log](!TODO). +- Starting on February 23, 2026, bots will need the `CREATE_GUILD_EXPRESSIONS` permission to create custom emoji and stickers. `MANAGE_GUILD_EXPRESSIONS` alone will no longer be sufficient. + +**4. Create Events Permission** + +- The `CREATE_EVENTS` permission (`1 << 44`) was created in July 2023 and split from `MANAGE_EVENTS` for users in December 2023. [Read the change log](/docs/change-log#clarification-on-permission-splits-for-expressions-and-events). +- As of today, bots now have access to the `CREATE_EVENTS` permission. Read the change log. +- Starting on February 23, 2026, bots will need the `CREATE_EVENTS` permission to create scheduled events. `MANAGE_EVENTS` alone will no longer be sufficient. + +### What Do You Need to Do? + +If your bot performs any of the following actions, please review and update your bot's permission requests before February 23, 2026: + +- **Pins messages:** Request the `Pin Messages` permission +- **Creates custom emoji or stickers:** Request the `Create Expressions` permission +- **Creates scheduled events:** Request the `Create Events` permission + +These changes are designed to give server administrators more control over what bots and users can do, ensuring better security and permission management. From b8d16fab8684669152b74e94139ae9b9bf6789d0 Mon Sep 17 00:00:00 2001 From: Colin Loretz Date: Fri, 21 Nov 2025 18:05:22 +0000 Subject: [PATCH 2/6] Change log placeholders --- .../2025-11-24-upcoming-permission-splits.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/change-log/2025-11-24-upcoming-permission-splits.md b/docs/change-log/2025-11-24-upcoming-permission-splits.md index 08cc1ed7e5..59f0d0f311 100644 --- a/docs/change-log/2025-11-24-upcoming-permission-splits.md +++ b/docs/change-log/2025-11-24-upcoming-permission-splits.md @@ -14,25 +14,29 @@ However, the breaking changes described below - where the old permissions will n **1. Pin Messages Permission** -- The `PIN_MESSAGES` permission (`1 << 51`) was split from `MANAGE_MESSAGES` on August 20, 2025. [Read the change log](/docs/change-log#pin-permission-split). +- The `PIN_MESSAGES` permission (`1 << 51`) was split from `MANAGE_MESSAGES` on August 20, 2025. +- [Read the change log](/docs/change-log#pin-permission-split). - Starting February 23, 2026, bots will need the `PIN_MESSAGES` permission to pin messages. `MANAGE_MESSAGES` alone will no longer be sufficient. **2. Bypass Slowmode Permission** - The `BYPASS_SLOWMODE` permission (`1 << 52`) is being split from `MANAGE_MESSAGES`, `MANAGE_CHANNEL` and `MANAGE_THREADS`. +- [Read the change log](!TODO). - Note: This primarily affects users, as bots are not affected by slowmode restrictions. - Starting on February 23, 2026, users will need the `BYPASS_SLOWMODE` permission to not be affected by slowmode restrictions. **3. Create Expressions Permission** - The `CREATE_GUILD_EXPRESSIONS` permission (`1 << 43`) was created in July 2023 and split from `MANAGE_GUILD_EXPRESSIONS` for users in December 2023. [Read the change log](/docs/change-log#clarification-on-permission-splits-for-expressions-and-events). -- As of today, bots now have access to the `CREATE_GUILD_EXPRESSIONS` permission. [Read the change log](!TODO). +- As of today, bots now have access to the `CREATE_GUILD_EXPRESSIONS` permission. +- [Read the change log](!TODO). - Starting on February 23, 2026, bots will need the `CREATE_GUILD_EXPRESSIONS` permission to create custom emoji and stickers. `MANAGE_GUILD_EXPRESSIONS` alone will no longer be sufficient. **4. Create Events Permission** - The `CREATE_EVENTS` permission (`1 << 44`) was created in July 2023 and split from `MANAGE_EVENTS` for users in December 2023. [Read the change log](/docs/change-log#clarification-on-permission-splits-for-expressions-and-events). -- As of today, bots now have access to the `CREATE_EVENTS` permission. Read the change log. +- As of today, bots now have access to the `CREATE_EVENTS` permission. +- [Read the change log](!TODO). - Starting on February 23, 2026, bots will need the `CREATE_EVENTS` permission to create scheduled events. `MANAGE_EVENTS` alone will no longer be sufficient. ### What Do You Need to Do? From b77b1868ed9658640ff4ab6716f4b5672b619c6a Mon Sep 17 00:00:00 2001 From: Colin Loretz Date: Mon, 24 Nov 2025 17:39:03 +0000 Subject: [PATCH 3/6] Added links to changelogs --- docs/change-log/2025-11-24-upcoming-permission-splits.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/change-log/2025-11-24-upcoming-permission-splits.md b/docs/change-log/2025-11-24-upcoming-permission-splits.md index 59f0d0f311..bc55a3bf00 100644 --- a/docs/change-log/2025-11-24-upcoming-permission-splits.md +++ b/docs/change-log/2025-11-24-upcoming-permission-splits.md @@ -21,7 +21,7 @@ However, the breaking changes described below - where the old permissions will n **2. Bypass Slowmode Permission** - The `BYPASS_SLOWMODE` permission (`1 << 52`) is being split from `MANAGE_MESSAGES`, `MANAGE_CHANNEL` and `MANAGE_THREADS`. -- [Read the change log](!TODO). +- [Read the change log](/docs/change-log#bypass-slow-mode-permission). - Note: This primarily affects users, as bots are not affected by slowmode restrictions. - Starting on February 23, 2026, users will need the `BYPASS_SLOWMODE` permission to not be affected by slowmode restrictions. @@ -29,14 +29,14 @@ However, the breaking changes described below - where the old permissions will n - The `CREATE_GUILD_EXPRESSIONS` permission (`1 << 43`) was created in July 2023 and split from `MANAGE_GUILD_EXPRESSIONS` for users in December 2023. [Read the change log](/docs/change-log#clarification-on-permission-splits-for-expressions-and-events). - As of today, bots now have access to the `CREATE_GUILD_EXPRESSIONS` permission. -- [Read the change log](!TODO). +- [Read the change log](/docs/change-log#guild-expressions-and-events-permissions-now-available-to-developers). - Starting on February 23, 2026, bots will need the `CREATE_GUILD_EXPRESSIONS` permission to create custom emoji and stickers. `MANAGE_GUILD_EXPRESSIONS` alone will no longer be sufficient. **4. Create Events Permission** - The `CREATE_EVENTS` permission (`1 << 44`) was created in July 2023 and split from `MANAGE_EVENTS` for users in December 2023. [Read the change log](/docs/change-log#clarification-on-permission-splits-for-expressions-and-events). - As of today, bots now have access to the `CREATE_EVENTS` permission. -- [Read the change log](!TODO). +- [Read the change log](/docs/change-log#guild-expressions-and-events-permissions-now-available-to-developers). - Starting on February 23, 2026, bots will need the `CREATE_EVENTS` permission to create scheduled events. `MANAGE_EVENTS` alone will no longer be sufficient. ### What Do You Need to Do? From 49e2de5935e9fc0c6fc14b88d204d960ad850ca3 Mon Sep 17 00:00:00 2001 From: Colin Loretz Date: Mon, 24 Nov 2025 12:15:54 -0800 Subject: [PATCH 4/6] Update docs/change-log/2025-11-24-upcoming-permission-splits.md Co-authored-by: advaith --- docs/change-log/2025-11-24-upcoming-permission-splits.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/change-log/2025-11-24-upcoming-permission-splits.md b/docs/change-log/2025-11-24-upcoming-permission-splits.md index bc55a3bf00..bdd50d29d7 100644 --- a/docs/change-log/2025-11-24-upcoming-permission-splits.md +++ b/docs/change-log/2025-11-24-upcoming-permission-splits.md @@ -16,7 +16,7 @@ However, the breaking changes described below - where the old permissions will n - The `PIN_MESSAGES` permission (`1 << 51`) was split from `MANAGE_MESSAGES` on August 20, 2025. - [Read the change log](/docs/change-log#pin-permission-split). -- Starting February 23, 2026, bots will need the `PIN_MESSAGES` permission to pin messages. `MANAGE_MESSAGES` alone will no longer be sufficient. +- Starting February 23, 2026, users and bots will need the `PIN_MESSAGES` permission to pin messages. `MANAGE_MESSAGES` alone will no longer be sufficient. **2. Bypass Slowmode Permission** From 558995f7f7caef3a178f1e863f72394962c33f5a Mon Sep 17 00:00:00 2001 From: Colin Loretz Date: Mon, 24 Nov 2025 12:15:59 -0800 Subject: [PATCH 5/6] Update docs/change-log/2025-11-24-upcoming-permission-splits.md Co-authored-by: advaith --- docs/change-log/2025-11-24-upcoming-permission-splits.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/change-log/2025-11-24-upcoming-permission-splits.md b/docs/change-log/2025-11-24-upcoming-permission-splits.md index bdd50d29d7..ffddedd684 100644 --- a/docs/change-log/2025-11-24-upcoming-permission-splits.md +++ b/docs/change-log/2025-11-24-upcoming-permission-splits.md @@ -20,7 +20,7 @@ However, the breaking changes described below - where the old permissions will n **2. Bypass Slowmode Permission** -- The `BYPASS_SLOWMODE` permission (`1 << 52`) is being split from `MANAGE_MESSAGES`, `MANAGE_CHANNEL` and `MANAGE_THREADS`. +- The `BYPASS_SLOWMODE` permission (`1 << 52`) is being split from `MANAGE_MESSAGES`, `MANAGE_CHANNEL`, and `MANAGE_THREADS`. - [Read the change log](/docs/change-log#bypass-slow-mode-permission). - Note: This primarily affects users, as bots are not affected by slowmode restrictions. - Starting on February 23, 2026, users will need the `BYPASS_SLOWMODE` permission to not be affected by slowmode restrictions. From bf3dad73fafba453bab5a2ff93122bd8631246c7 Mon Sep 17 00:00:00 2001 From: Colin Loretz Date: Mon, 24 Nov 2025 20:20:33 +0000 Subject: [PATCH 6/6] bypass_slowmode link --- docs/change-log/2025-11-24-upcoming-permission-splits.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/change-log/2025-11-24-upcoming-permission-splits.md b/docs/change-log/2025-11-24-upcoming-permission-splits.md index ffddedd684..af37ff3600 100644 --- a/docs/change-log/2025-11-24-upcoming-permission-splits.md +++ b/docs/change-log/2025-11-24-upcoming-permission-splits.md @@ -21,7 +21,7 @@ However, the breaking changes described below - where the old permissions will n **2. Bypass Slowmode Permission** - The `BYPASS_SLOWMODE` permission (`1 << 52`) is being split from `MANAGE_MESSAGES`, `MANAGE_CHANNEL`, and `MANAGE_THREADS`. -- [Read the change log](/docs/change-log#bypass-slow-mode-permission). +- [Read the change log](/docs/change-log#new-bypassslowmode-permission-permission-split). - Note: This primarily affects users, as bots are not affected by slowmode restrictions. - Starting on February 23, 2026, users will need the `BYPASS_SLOWMODE` permission to not be affected by slowmode restrictions.