botlabs-gg · l-zeuch · Sep 28, 2025 · Sep 20, 2025
diff --git a/content/docs/fun/_index.md b/content/docs/fun/_index.md
@@ -1,6 +1,6 @@
 +++
 title = "Fun"
-weight = 800
+weight = 900
 [sidebar]
     collapsed = true
 +++
diff --git a/content/docs/fun/reputation.md b/content/docs/fun/reputation.md
@@ -1,6 +1,6 @@
 +++
 title = "Reputation"
-weight = 810
+weight = 910
 description = "Track and manage reputation points for users."
 +++
 

diff --git a/content/docs/fun/soundboard.md b/content/docs/fun/soundboard.md
@@ -1,6 +1,6 @@
 +++
 title = "Soundboard"
-weight = 820
+weight = 920
 description = "Play sounds in voice channels with the soundboard system."
 +++
 

diff --git a/content/docs/reference/_index.md b/content/docs/reference/_index.md
@@ -1,4 +1,4 @@
 +++
 title = "Reference"
-weight = 900
+weight = 1000
 +++
diff --git a/content/docs/reference/custom-command-examples.md b/content/docs/reference/custom-command-examples.md
@@ -1,6 +1,6 @@
 +++
 title = "Custom Commands Examples"
-weight = 920
+weight = 1020
 description = "Copy-and-paste code, \"for education purposes only\"."
 +++
 

diff --git a/content/docs/reference/custom-commands-limits.md b/content/docs/reference/custom-commands-limits.md
@@ -1,6 +1,6 @@
 +++
 title = "Custom Commands Limits"
-weight = 930
+weight = 1030
 description = "Limits? I'm at my limit!"
 +++
 

diff --git a/content/docs/reference/custom-embeds.md b/content/docs/reference/custom-embeds.md
@@ -1,6 +1,6 @@
 +++
 title = "Custom Embeds"
-weight = 940
+weight = 1040
 description = "Be fancy, use embeds!"
 +++
 

diff --git a/content/docs/reference/custom-interactions.md b/content/docs/reference/custom-interactions.md
@@ -1,6 +1,6 @@
 +++
 title = "Custom Interactions"
-weight = 950
+weight = 1050
 description = "Even better than embeds!"
 +++
 

diff --git a/content/docs/reference/how-to-get-ids.md b/content/docs/reference/how-to-get-ids.md
@@ -1,6 +1,6 @@
 +++
 title = "How to Get IDs"
-weight = 960
+weight = 1060
 description = "Snowflake? ID? I don't know, but this page does!"
 +++
 

diff --git a/content/docs/reference/regex.md b/content/docs/reference/regex.md
@@ -1,6 +1,6 @@
 +++
 title = "Using RegEx"
-weight = 970
+weight = 1070
 description = "s/regex/dark voodoo/i"
 +++
 

diff --git a/content/docs/reference/templates/_index.md b/content/docs/reference/templates/_index.md
@@ -1,6 +1,6 @@
 +++
 title = 'Templates'
-weight = 910
+weight = 1010
 [sidebar]
     collapsed = true
 +++
diff --git a/content/docs/reference/templates/functions.md b/content/docs/reference/templates/functions.md
@@ -1,6 +1,6 @@
 +++
 title = "Functions"
-weight = 912
+weight = 1012
 description = "A list of all available functions in YAGPDB's custom command templates."
 +++
 

diff --git a/content/docs/reference/templates/syntax-and-data.md b/content/docs/reference/templates/syntax-and-data.md
@@ -1,6 +1,6 @@
 +++
 title = "Syntax and Data"
-weight = 911
+weight = 1011
 description = "Available data in custom commands and a quick syntax refresher."
 +++
 

diff --git a/content/docs/roles/_index.md b/content/docs/roles/_index.md
@@ -0,0 +1,4 @@
++++
+title = 'Roles'
+weight = 700
++++
diff --git a/content/docs/tools-and-utilities/autorole.md → content/docs/roles/autorole.md b/content/docs/tools-and-utilities/autorole.md → content/docs/roles/autorole.md
diff --git a/content/docs/roles/bulk-role.md b/content/docs/roles/bulk-role.md
@@ -0,0 +1,57 @@
++++
+title = "Bulk Role"
+weight = 730
+description = "Assign or remove roles to/from multiple members at once."
++++
+
+
+{{< callout context="caution" title="Warning: Required Bot Permissions" icon="outline/alert-triangle" >}}
+
+Make sure that the bot has permission to manage roles **and** that the role the bot is assigning is below the highest
+role the bot has.
+
+{{< /callout >}}
+
+![Bulk Role view](bulkrole_overview.png)
+
+Bulk role allows you to assign---or remove---a role en masse. YAGPDB provides several filters to narrow down assignment,
+which will be further explained below. You can only run one bulk role proess at any given time, so you'll have to either
+wait until the current one completes or simply just cancel it.
+
+{{< callout context="note" title="Note: Premium Only" icon="outline/info-circle" >}}
+
+Due to the nature of this operation requiring a lot of API calls to Discord and the associated cost with that, we
+provide this as a premium-only feature.
+
+{{< /callout >}}
+
+## Configuration
+
+### Target Role
+
+Select the role that you wish to assign or remove. Make sure that the bot's highest role is above this selected role.
+
+### Operation
+
+- **Assign role**: Assigns the selected role.
+- **Remove role**: removes the selected role.
+
+### Filter Type
+
+- **All members**: Assign or remove the target role to/from all members indiscriminately.
+- **Bots only**: Assign or remove the target role only to/from bots.
+- **Humans only**: Assign or remove the target role only to/from humans.
+- **Has specific roles**: Only care about members with at least one of these roles. Optionally you can tell the bot to
+  require **all** of your selected roles.
+- **Missing specific roles**: Like the above, but only on members without at least one of these roles. Optionally for
+  **all** selected roles.
+- **Joined after date**: Only care about members that joined after the selected date.
+- **Joined before date**: Only care about members that joined before the selected date.
+
+### Notification Channel
+
+Optionally select a channel you wish to receive notifications about the operation status of bulk assignment. The bot
+will let you know when it encountered an error during processing, otherwise after it wholly completed it.
+
+After you've configured everything to your liking, click the green "start" button and let the magic happen. If you
+changed your mind, you can always cancel it during the processing.
diff --git a/content/docs/roles/bulkrole_overview.png b/content/docs/roles/bulkrole_overview.png
diff --git a/...s/tools-and-utilities/copy_message_id.png → content/docs/roles/copy_message_id.png b/...s/tools-and-utilities/copy_message_id.png → content/docs/roles/copy_message_id.png
diff --git a/...tools-and-utilities/overview_autorole.png → content/docs/roles/overview_autorole.png b/...tools-and-utilities/overview_autorole.png → content/docs/roles/overview_autorole.png
diff --git a/...s-and-utilities/role_command_creation.png → content/docs/roles/role_command_creation.png b/...s-and-utilities/role_command_creation.png → content/docs/roles/role_command_creation.png
diff --git a/...utilities/role_command_group_creation.png → ...ocs/roles/role_command_group_creation.png b/...utilities/role_command_group_creation.png → ...ocs/roles/role_command_group_creation.png
diff --git a/...s/tools-and-utilities/rolemenu_create.png → content/docs/roles/rolemenu_create.png b/...s/tools-and-utilities/rolemenu_create.png → content/docs/roles/rolemenu_create.png
diff --git a/.../tools-and-utilities/rolemenu_example.png → content/docs/roles/rolemenu_example.png b/.../tools-and-utilities/rolemenu_example.png → content/docs/roles/rolemenu_example.png
diff --git a/...cs/tools-and-utilities/rolemenu_flags.png → content/docs/roles/rolemenu_flags.png b/...cs/tools-and-utilities/rolemenu_flags.png → content/docs/roles/rolemenu_flags.png
diff --git a/...cs/tools-and-utilities/rolemenu_react.png → content/docs/roles/rolemenu_react.png b/...cs/tools-and-utilities/rolemenu_react.png → content/docs/roles/rolemenu_react.png
diff --git a/.../tools-and-utilities/rolemenu_react_2.png → content/docs/roles/rolemenu_react_2.png b/.../tools-and-utilities/rolemenu_react_2.png → content/docs/roles/rolemenu_react_2.png
diff --git a/.../tools-and-utilities/rolemenu_react_3.png → content/docs/roles/rolemenu_react_3.png b/.../tools-and-utilities/rolemenu_react_3.png → content/docs/roles/rolemenu_react_3.png
diff --git a/...ls-and-utilities/self-assignable-roles.md → content/docs/roles/self-assignable-roles.md b/...ls-and-utilities/self-assignable-roles.md → content/docs/roles/self-assignable-roles.md
diff --git a/content/docs/tools-and-utilities/_index.md b/content/docs/tools-and-utilities/_index.md
@@ -1,4 +1,6 @@
 +++
 title = "Tools and Utilities"
-weight = 700
+weight = 800
+[sidebar]
+    collapsed = true
 +++
diff --git a/content/docs/welcome/premium.md b/content/docs/welcome/premium.md
@@ -24,6 +24,10 @@ A premium server unlocks the following benefits:
 
 - Enables retroactively applying a role to all members of a server.
 
+### Bulk Role
+
+- The [bulk role](/docs/roles/bulk-role) feature becomes available, allowing you to assign or remove a role in bulk.
+
 ### Common Template Scripting
 
 - Increase max operation count from 1 million to 2.5 million (`MaxOpsPremium`).

diff --git a/layouts/home.html b/layouts/home.html
@@ -50,9 +50,9 @@ <h2 id="quick-links" class="text-center">Quick Links</h2>
             "title" "Tools & Utilities"
             "icon" "outline/tools"
             "content" `
-- [Self-assignable roles](/docs/tools-and-utilities/self-assignable-roles/)
+- [Self-assignable roles](/docs/roles/self-assignable-roles/)
   - [YouTube tutorial video](https://www.youtube.com/watch?v=IaTfJ4vqHhc)
-- [Autoroles](/docs/tools-and-utilities/autorole)
+- [Autoroles](/docs/roles/autorole)
             ` }}
           {{ partial "inline/home-card.html" $opts }}