Discord Poll Template
Ask your community and let them actually vote. Members pick from a menu — one anonymous ballot each, changeable while the poll is open — and the results bars, counts and status restamp on the message live. Gate voting by role, hide results until close, set a deadline, and close with a public results announcement.
📊 Community Poll
{question}
{results}
🗳️ {votes} ballots cast · status: {status}
One ballot each — pick below, change it anytime.
🔒 Ballots are anonymous — the results update live on this message.
Copy and paste the Discord Poll text
This is the template's text as Discord markdown. Paste it into any channel and the headings, bold text, lists and subtext format exactly as they do in the preview; the card, buttons and menus come with the full template when you open it in DWEEB. Words in {braces} are DWEEB placeholders that fill in when you send from DWEEB — replace them by hand if you paste the text yourself. The Discord text formatting guide explains every piece of syntax it uses.
# 📊 Community Poll
**{question}**
{results}
> 🗳️ **{votes}** ballots cast · status: **{status}**
> One ballot each — pick below, change it anytime.
-# 🔒 Ballots are anonymous — the results update live on this message.When to use it
- Letting members choose the next event or topic
- Running votes with live result bars on the message
- Collecting feedback with results hidden until close
What's inside
Built with Discord's Components V2 layout system — the accent-striped card the Discord embed builder produces in place of a legacy embed:
- Container with accent stripe
- Formatted text
- Separator
- Dropdown menu
Tips
- Every piece of text, colour, emoji and link is editable — open it in DWEEB and make it yours.
- This template contains interactive components. Discord rejects it on a person-created webhook; use an application-owned webhook and configure the Poll plugin in DWEEB before sending.
- Use the measured, high-fidelity preview to check the layout before you send.
How to use this template
- Open it in DWEEB. Click “Use this template free” to load the template into the visual editor — no sign-up, no install.
- Make it yours. Edit the text, colours, emoji, links and images to match your server. The live preview updates as you type.
- Connect an app-owned destination. Follow DWEEB's guided setup for Poll, then choose a connected server and channel. Discord rejects interactive components on person-created webhooks.
- Send it. Review the live preview, then hit Send. You can also save it, share it as a link, schedule it, or export the message JSON.
Template JSON and compatibility
This example contains 2 top-level blocks and 9 components including nested blocks. Its text fields use 378 characters of the editor's message budget. The JSON below is exported from the same template that opens in DWEEB.
Import it through DWEEB's JSON panel, or adapt it for your own application. This is a Components V2 payload with flags: 32768, not a legacy embeds array. When executing a webhook yourself, include with_components=true in the request URL. See the Components V2 JSON reference for delivery requirements.
The custom IDs in this example are setup placeholders. Downloading JSON does not configure a running interaction handler: use the template's guided plugin setup in DWEEB, or connect your own handler to the application that owns the webhook.
Replace example text, images, links and any server placeholders before posting. Discord does not expand DWEEB placeholders when you send raw JSON from your own code. Review allowed mentions before sending text that names users or roles.
View the complete template JSON
{
"username": "Polls",
"components": [
{
"type": 17,
"accent_color": 3447003,
"components": [
{
"type": 10,
"content": "# 📊 Community Poll\n**{question}**"
},
{
"type": 14,
"divider": true,
"spacing": 1
},
{
"type": 10,
"content": "{results}"
},
{
"type": 14,
"divider": true,
"spacing": 1
},
{
"type": 10,
"content": "> 🗳️ **{votes}** ballots cast · status: **{status}**\n> One ballot each — pick below, change it anytime."
},
{
"type": 1,
"components": [
{
"type": 3,
"custom_id": "poll_select",
"placeholder": "Cast your vote…",
"min_values": 1,
"max_values": 1,
"options": [
{
"label": "Movie night",
"value": "o1",
"description": "Popcorn and a big screen",
"emoji": {
"name": "🍿"
}
},
{
"label": "Game tournament",
"value": "o2",
"description": "Bracket, prizes, glory",
"emoji": {
"name": "🎮"
}
},
{
"label": "Art jam",
"value": "o3",
"description": "Draw together on a theme",
"emoji": {
"name": "🎨"
}
},
{
"label": "Q&A with the team",
"value": "o4",
"description": "Ask the mods anything",
"emoji": {
"name": "🎤"
}
}
]
}
]
}
]
},
{
"type": 10,
"content": "-# 🔒 Ballots are anonymous — the results update live on this message."
}
],
"flags": 32768
}Use this template in a bot
The same message as a discord.js or discord.py bot sends it. Both are generated from the template above by DWEEB's code generator; for a cURL, JavaScript or Python webhook request, open the template with the Code tab.
discord.js code
// Components V2 message — discord.js v14.19 or newer.
// Designed in DWEEB (https://dweeb.faizo.net). Edit the text, then send.
const {
ActionRowBuilder,
ContainerBuilder,
MessageFlags,
SeparatorBuilder,
SeparatorSpacingSize,
StringSelectMenuBuilder,
StringSelectMenuOptionBuilder,
TextDisplayBuilder,
} = require("discord.js");
const container = new ContainerBuilder()
.setAccentColor(0x3498db)
.addTextDisplayComponents(
new TextDisplayBuilder().setContent(
[
"# 📊 Community Poll",
"**{question}**",
].join("\n"),
),
)
.addSeparatorComponents(
new SeparatorBuilder().setDivider(true).setSpacing(SeparatorSpacingSize.Small),
)
.addTextDisplayComponents(new TextDisplayBuilder().setContent("{results}"))
.addSeparatorComponents(
new SeparatorBuilder().setDivider(true).setSpacing(SeparatorSpacingSize.Small),
)
.addTextDisplayComponents(
new TextDisplayBuilder().setContent(
[
"> 🗳️ **{votes}** ballots cast · status: **{status}**",
"> One ballot each — pick below, change it anytime.",
].join("\n"),
),
)
.addActionRowComponents(
new ActionRowBuilder().addComponents(
new StringSelectMenuBuilder()
.setCustomId("poll_select")
.setPlaceholder("Cast your vote…")
.setMinValues(1)
.setMaxValues(1)
.addOptions(
new StringSelectMenuOptionBuilder()
.setLabel("Movie night")
.setValue("o1")
.setDescription("Popcorn and a big screen")
.setEmoji("🍿"),
new StringSelectMenuOptionBuilder()
.setLabel("Game tournament")
.setValue("o2")
.setDescription("Bracket, prizes, glory")
.setEmoji("🎮"),
new StringSelectMenuOptionBuilder()
.setLabel("Art jam")
.setValue("o3")
.setDescription("Draw together on a theme")
.setEmoji("🎨"),
new StringSelectMenuOptionBuilder()
.setLabel("Q&A with the team")
.setValue("o4")
.setDescription("Ask the mods anything")
.setEmoji("🎤"),
),
),
);
const text = new TextDisplayBuilder().setContent(
"-# 🔒 Ballots are anonymous — the results update live on this message.",
);
// Buttons and menus with a custom ID do nothing until your bot handles the
// interaction: client.on("interactionCreate", …) and match on customId.
// The design also sets username "Polls" — webhook-only options that
// channel.send() has no equivalent for. WebhookClient#send accepts them.
// Send it from any async context: a command handler, an event, a script.
await channel.send({
components: [container, text],
flags: MessageFlags.IsComponentsV2,
});discord.py code
# Components V2 message — discord.py 2.6 or newer.
# Designed in DWEEB (https://dweeb.faizo.net). Edit the text, then send.
import discord
from discord import ui
def build_view() -> ui.LayoutView:
view = ui.LayoutView(timeout=None)
view.add_item(
ui.Container(
ui.TextDisplay(
"# 📊 Community Poll\n"
"**{question}**",
),
ui.Separator(visible=True, spacing=discord.SeparatorSpacing.small),
ui.TextDisplay("{results}"),
ui.Separator(visible=True, spacing=discord.SeparatorSpacing.small),
ui.TextDisplay(
"> 🗳️ **{votes}** ballots cast · status: **{status}**\n"
"> One ballot each — pick below, change it anytime.",
),
ui.ActionRow(
ui.Select(
custom_id="poll_select",
placeholder="Cast your vote…",
min_values=1,
max_values=1,
options=[
discord.SelectOption(
label="Movie night",
value="o1",
description="Popcorn and a big screen",
emoji="🍿",
),
discord.SelectOption(
label="Game tournament",
value="o2",
description="Bracket, prizes, glory",
emoji="🎮",
),
discord.SelectOption(
label="Art jam",
value="o3",
description="Draw together on a theme",
emoji="🎨",
),
discord.SelectOption(
label="Q&A with the team",
value="o4",
description="Ask the mods anything",
emoji="🎤",
),
],
),
),
accent_colour=0x3498db,
),
)
view.add_item(
ui.TextDisplay(
"-# 🔒 Ballots are anonymous — the results update live on this message.",
),
)
return view
# Buttons and menus with a custom_id do nothing until your bot handles them:
# subclass ui.LayoutView with callbacks, or listen for on_interaction.
# The design also sets username "Polls" — webhook-only options that
# channel.send() has no equivalent for. discord.Webhook.send accepts them.
# Send it from any coroutine: a command, an event listener, a task.
await channel.send(view=build_view())Ready to use this template?
Open it in the visual Discord message builder, customize it for your server, and review the result before sending.
Use “Discord Poll” →Frequently asked questions
Do I need a bot to use this template?
It needs an application-owned webhook because it contains interactive components; Discord rejects those components on a person-created webhook. DWEEB detects the requirement and guides you through configuring Poll. Some handlers also need the DWEEB bot installed for server permissions.
How do I use this Poll template?
Click “Use this template free” to load it into the visual editor, change the text, colours and links to fit your server, then pick a channel or paste your Discord webhook URL and hit Send. You can also share it as a single link or export the message JSON.
Is DWEEB free?
Yes. DWEEB's full visual builder is free and needs no account. Working drafts and browser saves are local by default; optional connected features such as schedules, server libraries, AI, and plugins use the data required to work.