How to Create Discord Channel Aliases for Cross-Reference Linking

When you manage a server with many text channels, telling members to go to a specific channel can be confusing. They might not know the channel name or where to find it. Discord does not have a built-in alias feature, but you can use channel mentions to create a clickable cross-reference link. A channel mention behaves like an alias because it displays the channel name and links directly to it.

This article explains how to use channel mentions as aliases for cross-referencing. You will learn the exact syntax, how to create them on desktop and mobile, and how to use them in messages, announcements, and pinned posts. The guide also covers common mistakes and limitations so you can avoid broken links and permission errors.

How Channel Mentions Work as Aliases

Discord does not allow you to create a custom alias name for a channel. Instead, it provides a channel mention feature that acts as a direct link. When you type #channel-name in a message, Discord converts it into a clickable link. The link displays the channel name and, when clicked, jumps the user to that channel.

This behavior is identical to what an alias would do: you reference a channel using a short identifier, and the system resolves it to the actual channel. The mention works across all text channels, voice channels, and even threads if they are set to public. The only requirement is that the person viewing the mention has permission to see the target channel. If they do not, the mention appears as #deleted-channel.

Prerequisites

Before you can create channel aliases, ensure the following:

• You have the Manage Channels permission or can type in the channel where you want to post the mention.
• You know the exact name of the target channel. The autocomplete list shows channels you have permission to view.
• For hidden channels, you need the channel ID. Enable Developer Mode in User Settings > Advanced > Developer Mode.

Steps to Create a Channel Alias Using Mentions

The process is the same on desktop and mobile. Follow these steps to create a cross-reference link to any channel.

1. Open the text channel where you want to post the reference
   Navigate to the channel in your server. Click or tap the channel name in the left sidebar.
2. Type the # symbol followed by the channel name
   In the message input box, type #. A dropdown list appears showing channels you can view. Continue typing the channel name until you see it in the list.
3. Select the channel from the autocomplete list
   Click or tap the channel name in the list. Discord inserts the full mention, which looks like #channel-name in the input box but will be highlighted in blue.
4. Send the message
   Press Enter to send. The channel name appears as a clickable blue link. Anyone who clicks it is taken directly to that channel.

Using a Channel ID for Hidden Channels

If the channel does not appear in the autocomplete list because it is hidden from certain roles, you can still mention it using its ID.

1. Enable Developer Mode
   Go to User Settings > Advanced > Developer Mode and toggle it on.
2. Copy the channel ID
   Right-click the target channel in the server sidebar. Select Copy ID. The ID is a long numeric string.
3. Type the mention using the ID
   In the message input box, type <#, paste the ID, then type >. The result looks like <#123456789012345678>. Send the message. It will display as a clickable channel link.

Common Mistakes and Limitations

Even when you follow the steps correctly, some issues can prevent the alias from working as expected.

Mention Shows as #deleted-channel

This happens when the viewer does not have permission to see the target channel. The mention still exists, but it is not clickable for them. To fix this, adjust the channel permissions for the role or member. Go to the target channel > Edit Channel > Permissions and grant the View Channel permission. Alternatively, use a public channel that everyone can see.

Channel Name Changes After You Post the Mention

If you rename a channel after posting a mention, the mention automatically updates to show the new name. The link still works and points to the same channel. You do not need to edit the message. However, if the channel is deleted, the mention becomes #deleted-channel and is no longer clickable.

Cannot Mention a Channel in a Different Server

Channel mentions only work within the same server. You cannot create a cross-reference link to a channel in another server. If you need to reference an external channel, copy its invite link or use a message link instead. To get a message link, right-click a message in that channel and select Copy Message Link.

Discord Channel Mention Methods: Text vs ID

Item	Text Mention	ID Mention
Syntax	#channel-name	<#channel_id>
Autocomplete support	Yes, shows in dropdown	No, must type manually
Works for hidden channels	No, only visible channels appear	Yes, as long as you have the ID
Updates on rename	Yes, displays new name	Yes, displays new name
Permission required to view	Yes, same as ID mention	Yes, same as text mention

Channel mentions are the closest feature to aliases in Discord. They provide a clickable, self-updating link that works across all channels in a server. Use text mentions for quick references and ID mentions for channels that are not visible in the autocomplete list. Remember that mentions break if the channel is deleted, and they cannot cross server boundaries.