How to Migrate Roles to a New Discord Server

Moving your community to a new Discord server is a big task. You want to keep the same permissions, colors, and hierarchy your members are used to. Manually recreating each role takes too long and invites mistakes. This article explains how to copy roles from one server to another using Discord’s built-in server template feature and a third-party bot for more precise control. You will learn the exact steps to preserve role names, permissions, and position order.

Understanding Discord Role Migration Options

Discord does not include a direct “copy roles” button. The closest built-in tool is the server template feature. A server template captures the server’s roles, channels, permissions, and server settings. When you apply a template to a new server, Discord recreates those roles with the same names, colors, and permission settings. The role hierarchy is preserved as well.

Templates work well when you are creating a fresh server from scratch. They do not copy role assignments to individual members. If you need to move existing members with their roles intact, you must use a bot or manually reassign roles after migration. Templates also require the source server to have fewer than 500 members for the template to be shareable publicly. For private use, any server size works.

Third-party bots offer a more flexible solution. Bots like Dyno, Carl-bot, or Mee6 can read roles from one server and write them to another. Some bots also support copying role assignments per member. These bots require the server owner to authorize access and grant the necessary permissions.

Steps to Migrate Roles Using a Discord Server Template

This method works best when you want to set up a new server with the exact same role structure as the old one. It does not transfer member role assignments.

1. Create a server template on the source server
   Open Discord and go to your source server. Click the server name at the top left to open the dropdown menu. Select Server Settings. In the left sidebar, click Templates. Click Create Template. Give the template a name and an optional description. Click Create. Discord generates a template link.
2. Create a new server using the template
   Click the plus icon on the left sidebar to create a new server. Select Create My Own. In the next screen, choose For a club or community. Click Use a Template. Paste the template link from step 1. Click Create Server. Discord applies the template and creates all roles and channels.
3. Verify roles in the new server
   Go to Server Settings > Roles in the new server. Confirm that all role names, colors, and permission settings match the source server. Roles appear in the same order as the source server.

Steps to Migrate Roles and Assignments Using a Bot

Use a bot when you need to copy both roles and which members have those roles. This method works with Dyno, a popular moderation bot.

1. Invite Dyno to both servers
   Go to the Dyno website and log in with your Discord account. Click Add to Server. Select the source server and authorize the bot. Repeat for the destination server. Ensure Dyno has the Manage Roles permission in both servers.
2. Copy role configuration
   In the Dyno dashboard, go to the source server. Click Settings > Role Management. Click Export Roles. Dyno saves a JSON file with all role data. Switch to the destination server in the Dyno dashboard. Go to Settings > Role Management. Click Import Roles and upload the JSON file. Dyno recreates all roles with the same permissions and hierarchy.
3. Assign roles to members
   Dyno does not automatically reassign roles to members. Use a command like ?role add @user @rolename for each member or use a bot like Carl-bot that supports mass assignment. Carl-bot’s !role copy command can copy role assignments from one server to another if the member is in both servers.

Common Pitfalls When Migrating Roles

Role hierarchy breaks after migration

Roles must be in the same order in the new server. If you use a template, the order is preserved. With bots, check that the role positions match. Manually drag roles in Server Settings > Roles to fix the order.

Bot cannot manage roles because of permission order

Discord requires a bot’s role to be higher than the roles it tries to assign. Move the bot’s role to the top of the role list in Server Settings > Roles.

Member role assignments are missing

Templates do not transfer member role assignments. Only bots or manual reassignment can preserve which members had which roles. Use a bot that supports role assignment copying, such as Carl-bot or Dyno with additional commands.

Server Template vs Bot Migration Comparison

Item	Server Template	Dyno or Carl-bot
Role names and colors	Copied exactly	Copied exactly
Role permissions	Copied exactly	Copied exactly
Role hierarchy	Preserved	Preserved
Member role assignments	Not copied	Requires additional commands
Server size limit	Under 500 for public templates	No limit
Ease of use	Built-in, no bot needed	Requires bot setup and permissions

Now you can migrate roles to a new Discord server using either the built-in template feature or a third-party bot. Start with a server template if you only need the role structure. Use a bot like Dyno or Carl-bot if you need to preserve member assignments. After migration, always verify that role permissions and hierarchy are correct before inviting members. For advanced control, consider using Discord’s API with a custom script to automate the entire process.