Embed & Message removeComponent

$removeComponent[]

Removes a specific component (button, menu, text field, etc.) from a message using its custom identifier (customId).

Syntax
$removeComponent[customId]

$removeComponent[] — Remove a Component

$removeComponent[] removes a specific component from a message based on its customId. This allows dynamically disabling or removing buttons, menus, or input fields after an interaction.

Syntax

$removeComponent[customId]

Parameters

Parameter Required Description
customId Yes Identifier of the component to remove (defined at its creation).

Return Value

Removes the component from the message. If no component with this customId exists, nothing happens.

Usage

Removal after click

$onInteraction[confirm_btn]
$removeComponent[confirm_btn]
$removeComponent[cancel_btn]
$editMessage[✅ Action confirmed!]
$endInteraction

Disable a button after use

$onInteraction[claim_reward]
$removeComponent[claim_reward]
$sendMessage[$username has claimed the reward!]
$endInteraction

Remove multiple specific components

$onInteraction[reset_form]
$removeComponent[name_input]
$removeComponent[email_input]
$removeComponent[submit_btn]
$editMessage[Form reset]
$endInteraction
$onInteraction[select_role]
$removeComponent[role_menu]
$var[role;$input[role_menu]]
$giveRole[$authorID;$var[role]]
$editMessage[Role **$var[role]** assigned!]
$endInteraction

Notes

  • The customId must match exactly the one defined when creating the component ($addButton[customId;...], $addTextInput[customId;...], etc.).
  • If the component doesn’t exist, the function fails silently.
  • Used primarily in $onInteraction handlers to modify the message after a user action.
  • To remove all buttons at once, use $removeButtons[].
  • To remove everything, use $removeAllComponents[].