Create selfroles with Nekotina

Published on May 22nd, 20264 min read

Learn how to set up a self-assignable role panel using Server Actions and the Message Builder.

Ads

Selfroles (or role panels) let your server members assign or remove roles by clicking buttons on a message. With Nekotina you can build them by combining two dashboard tools:

  • Server Actions: define what happens when a button is clicked (for example, toggling a role).
  • Message Builder: create the message with buttons and send it to your chosen channel.

Prerequisites

Before you start, make sure that:

  1. You have access to the Nekotina dashboard with administrator permissions on the server.
  2. Nekotina's role is above the roles you want to assign.
  3. Nekotina has the Manage Roles permission.
  4. You have already created the roles you want to offer in Discord's settings.

This is how the final panel will look in Discord once you complete all the steps:

Preview
Nekotina
NekotinaAPP
Select the roles you're interested in by clicking the buttons below.

Server roles

Click a button to receive or remove a role.
Selfroles panel published in one of your server channels.

Step 1 — Create server actions

For each role on the panel you need an action with the Toggle role step. This step adds the role if the user doesn't have it, or removes it if they already do.

  1. Open the dashboard and select your server.
  2. Go to Utilities → Server Actions.
  3. Click Create action.
  4. Give it a clear name, such as Selfrole - Announcements.
  5. Add a Toggle role step and select the matching role.
  6. Save the action.

Repeat this process for each role on the panel. If you have 4 roles, you need 4 separate actions.

Suggested nameStepRole
Selfrole - AnnouncementsToggle role@Announcements
Selfrole - EventsToggle role@Events
Selfrole - GamingToggle role@Gaming

Confirmation response (optional)

On Premium servers you can add a second Reply with message step, marked as Ephemeral, to customize the confirmation the user sees when they click a button:

Done, your role has been updated.
Preview
Nekotina
NekotinaAPP
Done, your role has been updated.
Custom ephemeral reply with Premium. Only the user who clicked the button can see it.

On the free plan you can only configure 1 step per action (toggling the role). Even so, Nekotina still sends an automatic ephemeral confirmation with a default message that you cannot customize from the dashboard. To choose your own response text, you need Premium.

Preview
Nekotina
NekotinaAPP
Your roles have been updated successfully.
Automatic reply on the free plan. The text is fixed and cannot be customized.

Step 2 — Create the message in the Message Builder

  1. Go to Utilities → Message Builder.
  2. Click Create message.
  3. Give it a descriptive name, such as Selfroles panel.
  4. Write the panel content or add an embed with a title and description:
Select the roles you're interested in by clicking the buttons below.
  1. Add one or more button rows with clear labels (Announcements, Events, Gaming, etc.).
Preview
Nekotina
NekotinaAPP
Select the roles you're interested in by clicking the buttons below.

Server roles

Click a button to receive or remove a role.
Message preview while configuring it in the Message Builder.

For each button on the message:

  1. Change the button type from Link to Server action.
  2. Select the action you created in step 1 (for example, Selfrole - Announcements).
  3. Repeat for each button on the panel.

Each button must point to a different action. The same action cannot be used on two buttons in the same message.

Step 4 — Send the message to a channel

  1. Review the message preview in the builder.
  2. Click Send and choose the channel where you want to publish the panel (for example, #roles or #info).
  3. Confirm the send.

The message will appear in Discord with the buttons ready to use. Members can click the buttons to toggle their roles.

Limits to keep in mind

FreePremium
Steps per action110
Confirmation messageDefault, not editableCustomizable
Button rows per message55
Buttons per row55
Buttons per message (max.)2525
Embeds per message1010

On the free plan, clicking a button triggers an automatic confirmation with a fixed message. With Premium you can add a Reply with message step to choose the response text.

Tips

  • Use short, clear names for actions; they will help you find them when linking buttons.
  • Organize buttons by category in separate rows (for example, one row for notification roles and another for activity roles).
  • If a button doesn't respond, check that the action is saved and linked correctly.
  • You can edit the message later from the builder if you need to change text or buttons.

Common issues

Flow summary

1. Create action → Toggle role
2. Create message → Add buttons
3. Link each button → Its action
4. Send message → Server channel

That's it! You now have a working selfroles panel on your server with Nekotina.

Ads
Back to guides