GitHub Contributor Role Template
Give contributors the recognition they've earned. Members link their GitHub account through GitHub's own OAuth and RoleLogic grants roles from real contribution data — commits, opened and merged pull requests, and issues on any public repository you choose.
🐙 Link your GitHub
Commits, pull requests, merged PRs and issues — link your GitHub account and the roles you've earned as a contributor are granted automatically.
Works with any public repository — perfect for open-source projects, hackathons and dev communities.
🛡️ Admins: choose repos and contribution tiers in the RoleLogic dashboard.
Copy and paste the GitHub Contributor Role 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. The Discord text formatting guide explains every piece of syntax it uses.
# 🐙 Link your GitHub
Commits, pull requests, merged PRs and issues — link your GitHub account and the roles you've earned as a contributor are granted automatically.
Works with any public repository — perfect for open-source projects, hackathons and dev communities.
-# 🛡️ Admins: choose repos and contribution tiers in the [RoleLogic dashboard](https://rolelogic.faizo.net/dashboard?plugin_select=https%3A%2F%2Fplugin-rolelogic.faizo.net%2Fgithub-contributor-role).When to use it
- Rewarding open-source contributors with a Discord role
- Gating a contributors-only channel on merged PRs
- Ranking hackathon or dev-community members by activity
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
- Buttons
Tips
- Every piece of text, colour, emoji and link is editable — open it in DWEEB and make it yours.
- The message posts through any Discord webhook, but its GitHub Contributor Role link only works after that service is configured for your server. DWEEB opens the required setup step when you choose the template.
- 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.
- Finish the linked-service setup. Configure GitHub Contributor Role for your server when DWEEB opens its setup step, then choose any Discord webhook as the destination.
- 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 7 components including nested blocks. Its text fields use 488 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 link buttons depend on the linked service's server setup. Importing the JSON copies the layout and links; it does not configure that service.
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.
Download GitHub Contributor Role JSON
View the complete template JSON
{
"username": "GitHub Link",
"components": [
{
"type": 17,
"accent_color": 10181046,
"components": [
{
"type": 10,
"content": "# 🐙 Link your GitHub\nCommits, pull requests, merged PRs and issues — link your GitHub account and the roles you've earned as a contributor are granted automatically."
},
{
"type": 14,
"divider": true,
"spacing": 1
},
{
"type": 10,
"content": "Works with any public repository — perfect for open-source projects, hackathons and dev communities."
},
{
"type": 1,
"components": [
{
"type": 2,
"style": 5,
"label": "Link GitHub",
"emoji": {
"name": "🐙"
},
"url": "https://plugin-rolelogic.faizo.net/github-contributor-role/verify?guild={server_id}"
}
]
}
]
},
{
"type": 10,
"content": "-# 🛡️ Admins: choose repos and contribution tiers in the [RoleLogic dashboard](https://rolelogic.faizo.net/dashboard?plugin_select=https%3A%2F%2Fplugin-rolelogic.faizo.net%2Fgithub-contributor-role)."
}
],
"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,
ButtonBuilder,
ButtonStyle,
ContainerBuilder,
MessageFlags,
SeparatorBuilder,
SeparatorSpacingSize,
TextDisplayBuilder,
} = require("discord.js");
const container = new ContainerBuilder()
.setAccentColor(0x9b59b6)
.addTextDisplayComponents(
new TextDisplayBuilder().setContent(
[
"# 🐙 Link your GitHub",
"Commits, pull requests, merged PRs and issues — link your GitHub account and the roles you've earned as a contributor are granted automatically.",
].join("\n"),
),
)
.addSeparatorComponents(
new SeparatorBuilder().setDivider(true).setSpacing(SeparatorSpacingSize.Small),
)
.addTextDisplayComponents(
new TextDisplayBuilder().setContent(
"Works with any public repository — perfect for open-source projects, hackathons and dev communities.",
),
)
.addActionRowComponents(
new ActionRowBuilder().addComponents(
new ButtonBuilder()
.setStyle(ButtonStyle.Link)
.setLabel("Link GitHub")
.setEmoji("🐙")
.setURL(
"https://plugin-rolelogic.faizo.net/github-contributor-role/verify?guild={server_id}",
),
),
);
const text = new TextDisplayBuilder().setContent(
"-# 🛡️ Admins: choose repos and contribution tiers in the [RoleLogic dashboard](https://rolelogic.faizo.net/dashboard?plugin_select=https%3A%2F%2Fplugin-rolelogic.faizo.net%2Fgithub-contributor-role).",
);
// The design also sets username "GitHub Link" — 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(
"# 🐙 Link your GitHub\n"
"Commits, pull requests, merged PRs and issues — link your GitHub account and the roles you've earned as a contributor are granted automatically.",
),
ui.Separator(visible=True, spacing=discord.SeparatorSpacing.small),
ui.TextDisplay(
"Works with any public repository — perfect for open-source projects, hackathons and dev communities.",
),
ui.ActionRow(
ui.Button(
style=discord.ButtonStyle.link,
label="Link GitHub",
emoji="🐙",
url="https://plugin-rolelogic.faizo.net/github-contributor-role/verify?guild={server_id}",
),
),
accent_colour=0x9b59b6,
),
)
view.add_item(
ui.TextDisplay(
"-# 🛡️ Admins: choose repos and contribution tiers in the [RoleLogic dashboard](https://rolelogic.faizo.net/dashboard?plugin_select=https%3A%2F%2Fplugin-rolelogic.faizo.net%2Fgithub-contributor-role).",
),
)
return view
# The design also sets username "GitHub Link" — 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 “GitHub Contributor Role” →Frequently asked questions
Do I need a bot to use this template?
You can post the message through any webhook because its button is a normal link. The linked GitHub Contributor Role must still be configured for your server before the action behind that link works.
How do I use this GitHub contributor role 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.