Developer Portal

The Developer Portal is where you create and configure your Discord application for activities.

Discord Developer Portal applications page showing the list of applications with the New Application button in the top right

FocusThe New Application button and the applications listZoom100%NotesShow discord.com/developers/applications with the 'New Application' button visible. Include portal header and sidebar.

Create an Application

1. Go to discord.com/developers/applications.
2. Click New Application in the top right.
3. Enter a name for your application.
4. Click Create.

Discord Developer Portal 'Create an Application' dialog with a text field for the application name and Create button

FocusThe application creation modal with the name input fieldZoom100%NotesShow the modal after clicking 'New Application'. Name field should contain 'My Activity'. Create button visible.

Enable Activities

To enable activities for your application:

1. Open your application in the Developer Portal.
2. Navigate to Activities in the left sidebar.
3. Toggle the Enable Activities switch to on.
4. This unlocks the URL Mappings section and other activity-specific settings.

Once enabled, Discord treats your application as an activity that can be launched from voice channels, text channels, and DMs.

Discord Developer Portal Activities tab showing the Enable Activities toggle in the on position, with URL Mappings section visible below

FocusThe Activities sidebar item and Enable Activities toggle turned onZoom100%NotesShow the Activities tab selected in sidebar. Enable Activities toggle ON. URL Mappings section visible below (even if empty).

URL Mappings

Discord doesn't let activities make network requests directly. All traffic goes through Discord's proxy. URL Mappings tell Discord where to forward those requests.

The root mapping points to your app's URL: a tunnel URL during development, or your production URL when deployed.

Additional mappings let your activity load external resources through Discord's proxy. Add entries for any third-party domains your frontend needs to access.

Discord Developer Portal URL Mappings section showing root mapping '/' pointing to a Cloudflare tunnel URL, with an additional mapping for external services

FocusThe URL Mappings table with root mapping filled inZoom100%NotesShow the URL Mappings section with ONLY the root '/' mapped to a tunnel URL. One mapping row, showing a fresh initial setup. Include the Add button to hint more can be added.

Entry Point Command

Discord requires an entry point command to launch activities. This is a special command type (type 4) that appears in the Activities shelf — it is different from regular slash commands. When a user clicks your activity in the shelf, Discord invokes this command to start the embedded session.

Without the bot token, you need to create the command manually:

1. Go to your application in the Developer Portal.
2. Navigate to Commands in the left sidebar.
3. Click New Command and select the entry point command type.
4. Set the command name (this is what users see in the Activities shelf).
5. Save your changes.

Discord Developer Portal Commands tab showing the entry point command configuration with the special entry point command type selected

FocusThe Commands section with entry point command type setupZoom100%NotesShow the Commands tab with the entry point command form. The command type should be the entry point type (type 4). Name field filled with something like 'my-activity'.

OAuth2 Setup

Navigate to the OAuth2 tab and add a redirect URI. Select the scopes (permission categories that control what user data your app can access) your activity requires. Common defaults are identify and guilds.

Discord Developer Portal OAuth2 tab showing Redirects section with 'https://localhost' entered and scope checkboxes with 'identify' and 'guilds' selected

FocusThe redirect URI field and scope checkboxesZoom100%NotesShow OAuth2 tab with 'https://localhost' as redirect URI. Scopes 'identify' and 'guilds' checked.

Testing

After configuring URL Mappings, open Discord and join a voice channel. Click the Activities button in the voice channel controls, then select your activity from the list.

Discord desktop client in a voice channel with the activity being launched from the Activities shelf, showing the embedded panel loading

FocusThe Activities shelf with the activity selected and loading in the embedded panelZoom100%NotesShow the activity actually running inside the embedded panel after launch. The voice channel participants should be visible alongside the activity iframe content. Focus on proving the end-to-end setup works.

Next Steps