Welcome to the iframe tutorial!
This tutorial assumes you have already completed the Getting Started with WidgetBot tutorial. If you have not, please read it and invite a cluster bot.
If you need any assistance adding WidgetBot, please ask in the server. However, please make sure you mention what the issue is, send your code in a codeblock (
```), include your server id and WidgetBot instance, and optionally include a link to your site.
To get started, add the following code where you want the widget to display.
<iframe src="https://cl2.widgetbot.io/channels/299881420891881473/355719584830980096" height="600" width="800"></iframe>
If you run your site with this code, you should see the widget, showing the official WidgetBot server.
Setting your server¶
The WidgetBot URL has the following format:
In the example code, the SHARD is
cl2, the SERVERID is
299881420891881473, and the Channel ID is
To set it to your server, you must change the shard, Server ID, and Channel ID.
You can get the Server and Channel IDs from Discord.
- One way is to open Discord in your browser and take them from the URL. The URL has the following format:
- Another way is to go to the Appearance tab in User Settings, and turn on Developer Mode. Then, right-click the server icon or channel and click
The Channel ID you choose will be the default channel that will show when the widget loads. However, the user can switch the channel.
shard is the WidgetBot cluster you are using. This can be one of the following:
If using DisWeb or self-hosted, change
cl2.widgetbot.io to the full [sub]domain.
You must use the correct shard for the bot you added to your server.
Once you set the Server ID, Channel ID, and Shard, the widget should now show your server.
You have successfully set up WidgetBot.