How to Add a Discord Server Viewer to Your Website

A Discord server viewer lets visitors see useful live information from your community without opening Discord first. That can include the server name, online members, public voice channels and an invitation link.

Before you begin: you need permission to manage the Discord server and a website that can run PHP 7.1 or later for the premium Discord Viewer themes.

Open Discord on desktop or in a web browser.
Select your server and open Server Settings.
Open the Widget section.
Enable the server widget.
Choose the invite channel that visitors should use when they join.

Discord's widget data is only available while the server widget is enabled. The official data can include the server name, public voice and stage channels, widget members, presence count and an instant invite when one is configured.

Discord's official widget documentation describes the current widget fields.

2. Find your widget JSON URL

Your JSON address uses the server ID in this format:

https://discord.com/api/guilds/YOUR_SERVER_ID/widget.json

Replace YOUR_SERVER_ID with the numeric ID of your Discord server. If you do not already see IDs in Discord, enable Developer Mode in Discord's Advanced settings, then right-click the server icon and copy the server ID.

Do not use a bot token. Discord Viewer uses the public server-widget JSON feed. Never place a private bot token in a browser-facing settings page.

3. Test the feed before installing anything

Open the JSON URL in a browser. A working feed should return structured data rather than a normal web page. Check that the server name is correct and that the response contains the public channels or online members you expect.

If Discord returns an error, check that the widget is enabled and that you copied the correct server ID.

4. Choose the viewer you want to install

The free Mini viewer is a compact starting point. Premium themes add full Settings Panel support, DV Colour Studio controls, logo options and a wider range of layouts and effects.

Discord Viewer showing a styled Discord server display — Discord Viewer turns the public widget feed into a fuller, styled server display.

5. Upload the viewer files

Unzip the downloaded package on your computer.
Upload the complete theme folder to your PHP-capable web hosting.
Keep the supplied folder structure intact.
Open the included ReadMe file for theme-specific paths and options.

Avoid uploading only the main PHP file. The viewer also relies on its CSS, images, data and supporting files.

6. Add the JSON URL and configure the display

Open the theme's Settings Panel, paste in the widget JSON URL and save it. You can then set the logo, choose whether to show only occupied channels, preview the viewer and adjust the available theme controls.

Discord Viewer Settings Panel — The Settings Panel keeps the server source and display controls in one place.

7. Place it on your website

The cleanest method depends on your site. You can link directly to the viewer page, place it within an iframe where appropriate, or integrate the theme into an existing PHP page. Keep the viewer responsive and test it at mobile widths before publishing.

Common problems

No server data: confirm that the widget is enabled and the JSON URL opens directly.
No channels: only public voice or stage channels available to everyone are exposed by Discord's widget.
No invite: choose an invite channel in the server's Widget settings.
PHP error: confirm your hosting meets the theme's PHP requirement.
Old settings still showing: clear the browser cache and check that the settings file is writable.