👋 WELCOME SETUP

Mit Welcome Setup begrüßt THE GRID jedes Mitglied, das deinem Server beitritt, mit einer Nachricht in einem festen Textkanal – zum Beispiel #willkommen. Wie die Nachricht aussieht, bestimmst du im Dashboard.

Die Nachricht besteht aus Bausteinen (Discord Components V2): Text, Trennlinie, Section (Text mit Bild oder Link-Button daneben), Container mit farbigem Balken, eine Reihe Link-Buttons und eine Bildergalerie. Platzhalter wie {user} oder {memberCount} ersetzt der Bot beim Senden durch echte Werte.

Klassische Embeds, freien Text außerhalb der Bausteine, Datei-Anhänge und Auswahlmenüs gibt es hier nicht. Buttons öffnen immer eine Internetadresse – Rollen per Klick vergibst du mit Reaction Roles. Welcome Setup ist in allen Tarifen ohne Begrenzung nutzbar.

With Welcome Setup, THE GRID greets every member who joins your server with a message in a fixed text channel – for example #welcome. You decide in the dashboard what the message looks like.

The message is made of building blocks (Discord Components V2): text, divider, section (text with an image or a link button next to it), container with a coloured bar, a row of link buttons and an image gallery. Placeholders such as {user} or {memberCount} are replaced with real values when the bot sends the message.

Classic embeds, free text outside the blocks, file attachments and select menus are not available here. Buttons always open a web address – to hand out roles with a click, use Reaction Roles. Welcome Setup is available in every plan without limits.

Gestalte die Begrüßung zuerst und schalte sie erst dann ein – so bekommt kein neues Mitglied eine halbfertige Nachricht.

• Ab wann es gilt: ab dem nächsten Beitritt. Der Bot liest die Einstellungen bei jedem Beitritt neu, ein Neustart ist nicht nötig.
• Ausschalten: Schalter aus – Kanal und Bausteine bleiben gespeichert und sind beim nächsten Einschalten wieder da.
• Schalter springt zurück? Dann konnte die Änderung nicht gespeichert werden; eine Meldung gibt es dafür nicht. Lade die Seite neu und versuche es noch einmal.
• Neuer Kanal fehlt in der Liste? Neu angelegte Kanäle können ein paar Minuten brauchen, bis sie erscheinen. Lade den Editor dann neu.

Design the welcome message first and only then switch it on – that way no new member gets a half-finished message.

• When it applies: from the next join. The bot reads the settings again on every join; no restart is needed.
• Switching off: turn the switch off – the channel and the blocks stay saved and are back when you switch it on again.
• Switch jumps back? Then the change could not be saved; there is no message for this. Reload the page and try again.
• New channel missing from the list? Newly created channels can take a few minutes to appear. Reload the editor then.

Die Welcome-Setup-Seite zeigt auf einen Blick, ob die Begrüßung bereit ist.

• „Zurück zu Moderation“ führt zurück zur Moderationsseite.
• Schalter „Willkommensnachricht aktiviert“ (Standard: aus) – schaltet die Begrüßung ein oder aus und speichert sofort.
• „Willkommenskanal“ – der gespeicherte Kanal oder „Nicht konfiguriert“. Auch ein in Discord gelöschter Kanal erscheint hier als „Nicht konfiguriert“ – siehe Bekannte Fehler.
• „Willkommensnachricht“ – „Konfiguriert“, sobald Bausteine gespeichert sind, sonst „Nicht konfiguriert“.
• Rechte-Banner – prüft Kanal und Bot-Rechte, siehe unten.
• „Editor öffnen“ – öffnet den Editor.

Das Rechte-Banner

Das Banner ist derzeit nur auf Deutsch. Es wird beim Laden der Seite berechnet – legst du den Schalter um, ändert es sich erst nach dem Neuladen.

Das Abzeichen auf der Moderationsseite

Auch die Karte „Welcome Setup“ auf der Moderationsseite trägt neben dem Titel ein Abzeichen (nur auf Deutsch). Fährst du mit der Maus darüber, erscheinen Details. Alle Abzeichen erklärt die Moderations-Übersicht.

The Welcome Setup page shows at a glance whether your welcome message is ready. The permission banner and the badges are currently only shown in German – their meaning is translated below.

• “Back to Moderation” takes you back to the moderation page.
• Switch “Welcome message enabled” (default: off) – turns the welcome message on or off and saves immediately.
• “Welcome Channel” – the saved channel or “Not configured”. A channel that was deleted in Discord also shows up as “Not configured” – see Known issues.
• “Welcome Message” – “Configured” as soon as blocks are saved, otherwise “Not configured”.
• Permission banner – checks the channel and the bot's permissions, see below.
• “Open Editor” – opens the editor.

The permission banner

The banner is calculated when the page loads – if you flip the switch, it only changes after a reload.

The badge on the moderation page

The “Welcome Setup” card on the moderation page also shows a badge next to its title (German only). Hover over it for details. All badges are explained in the moderation overview.

Im Editor baust du die Begrüßung und wählst den Kanal. Du erreichst ihn über „Editor öffnen“ auf der Welcome-Setup-Seite.

Aufbau

• Oben: „Zurück“ (zur Welcome-Setup-Seite), der Titel „Welcome Message Editor“, rechts die Kanalwahl und „Speichern“.
• Links „Komponenten“: die Liste deiner Bausteine. „Komponente hinzufügen“ öffnet ein Menü mit den sechs Bausteinen.
• Unter der Liste „Verfügbare Platzhalter“: Ein Klick auf einen Platzhalter kopiert ihn in die Zwischenablage – ohne sichtbare Bestätigung.
• Rechts „Vorschau“: eine Nachbildung der Nachricht in Discord, mit dem Absender „THE GRID“.

Die Bausteinliste

• Jede Zeile zeigt den Typ und eine Kurzvorschau, etwa „Mit Linie“ beim Separator oder „2 Button(s)“ bei der Action Row.
• Stift: öffnet den Dialog „… bearbeiten“. „Übernehmen“ übernimmt deine Eingaben in die Seite, „Abbrechen“ verwirft sie. Der Dialog schließt auch mit × oder einem Klick neben das Fenster – nicht aber mit der Esc-Taste.
• Papierkorb: löscht den Baustein sofort und ohne Rückfrage – einen Container samt Inhalt.
• „+“ am Container: fügt einen Baustein in den Container ein. Möglich sind alle Typen außer einem weiteren Container.
• Ziehen: Mit den Punkten links an jeder Zeile ziehst du Bausteine in eine neue Reihenfolge – auf der obersten Ebene und innerhalb eines Containers. Zwischen Container und oberster Ebene lässt sich nichts verschieben: Lege den Baustein am Ziel neu an und lösche ihn am alten Platz.

Die Vorschau ist nur eine Annäherung

Die Vorschau hilft beim Gestalten, zeigt aber nicht alles so wie Discord:

• Markdown wie **fett** erscheint roh. In Discord ist der Text formatiert.
• Platzhalter zeigen Beispielwerte: „@Neues Mitglied“, „NeuesMitglied“, „Mein Server“ und „1,234“. In Discord steht die Mitgliederzahl ohne Trennzeichen, etwa „1234“.
• {userAvatar} im Text erscheint als kleines Bild – in Discord ist es nur ein Link.
• Platzhalter in Bildadressen setzt die Vorschau nicht ein und zeigt ein kaputtes Bild. In Discord setzt der Bot den Wert ein.
• Eine Section ohne Bild und ohne Button sieht in der Vorschau normal aus – der Bot sendet dann aber gar keine Begrüßung (siehe Bausteine).

In the editor you build the welcome message and choose the channel. You reach it with “Open Editor” on the Welcome Setup page.

Layout

• Top: “Back” (to the Welcome Setup page), the title “Welcome Message Editor”, on the right the channel selection and “Save”.
• Left, “Components”: the list of your blocks. “Add Component” opens a menu with the six blocks.
• Below the list, “Available Placeholders”: clicking a placeholder copies it to the clipboard – without any visible confirmation.
• Right, “Preview”: a replica of the message in Discord, sent by “THE GRID”.

The block list

• Every row shows the type and a short preview, for example “With line” for a separator or “2 Button(s)” for an action row.
• Pencil: opens the “Edit …” dialog. “Apply” takes your input over into the page, “Cancel” discards it. The dialog also closes with × or a click next to the window – but not with the Esc key.
• Bin: deletes the block immediately, without confirmation – a container including its content.
• “+” on a container: adds a block inside the container. Every type is possible except another container.
• Drag: use the dots on the left of each row to reorder blocks – on the top level and within a container. Nothing can be moved between a container and the top level: create the block again at the target and delete it at its old place.

The preview is only an approximation

The preview helps while designing, but it does not show everything the way Discord does:

• Markdown such as **bold** appears raw. In Discord the text is formatted.
• Placeholders show sample values: “@New Member”, “NewMember”, “My Server” and “1,234”. In Discord the member count has no separator, for example “1234”.
• {userAvatar} in a text appears as a small image – in Discord it is just a link.
• The preview does not fill in placeholders in image addresses and shows a broken image. In Discord the bot inserts the value.
• A section without an image and without a button looks normal in the preview – but then the bot sends no welcome message at all (see Building blocks).

Sechs Bausteine stehen zur Wahl. Du kannst sie frei kombinieren und mehrfach verwenden.

„Als Spoiler anzeigen (verschwommen)“ am Container derzeit ohne Wirkung – der Container wird immer unverschwommen gesendet. Bei den Bildern einer Media Gallery wirkt die Option.

• Nur graue Link-Buttons: Jeder Button öffnet eine Adresse. Ein Emoji-Feld, eine Farbwahl oder Buttons, die Rollen vergeben, gibt es nicht. Ein Emoji kannst du einfach an den Anfang des Button-Texts schreiben, etwa „📘 Regelwerk“.
• Separator: Den Abstand kannst du nicht einstellen, nur die Linie ein- oder ausschalten.
• Grenzen von Discord: Discord begrenzt außerdem, wie viele Bausteine und wie viel Text eine Nachricht insgesamt haben darf. Das Dashboard prüft keine dieser Grenzen – halte die Begrüßung überschaubar und teste sie.

Six blocks are available. You can combine them freely and use each of them several times.

“Show as spoiler (blurred)” on a container currently has no effect – the container is always sent unblurred. For the images of a media gallery, the option works.

• Grey link buttons only: every button opens an address. There is no emoji field, no colour choice and no buttons that hand out roles. You can simply put an emoji at the start of the button text, for example “📘 Rulebook”.
• Separator: the spacing cannot be changed; you can only switch the line on or off.
• Discord's limits: Discord also limits how many blocks and how much text a message may have in total. The dashboard does not check any of these limits – keep the welcome message manageable and test it.

Platzhalter ersetzt der Bot beim Senden durch die Daten des neuen Mitglieds und deines Servers. In den Dialogen „Text Display“ und „Section“ fügst du sie per Klick ein; der Kasten „Verfügbare Platzhalter“ im Editor kopiert sie in die Zwischenablage.

• Groß- und Kleinschreibung zählt: {memberCount} funktioniert, {membercount} nicht – ebenso bei {userAvatar}. Falsch geschriebene Platzhalter stehen als Text in der Nachricht.
• Hier ersetzt der Bot Platzhalter: im Text eines Text Display, im Section-Text, in der „Thumbnail URL“ einer Section und in der „Bild URL“ einer Media Gallery.
• Hier nicht: in Button-Texten und Button-Adressen sowie in Beschreibungen (Alt-Texten).
• Nur diese sechs: Andere Platzhalter, etwa aus dem Ticket-System, funktionieren hier nicht.

The bot replaces placeholders with the details of the new member and your server when it sends the message. In the “Text Display” and “Section” dialogs you insert them with a click; the “Available Placeholders” box in the editor copies them to the clipboard.

• Upper and lower case matter: {memberCount} works, {membercount} does not – the same goes for {userAvatar}. Misspelled placeholders appear as plain text in the message.
• The bot replaces placeholders here: in the text of a Text Display, in the section text, in the “Thumbnail URL” of a section and in the “Image URL” of a media gallery.
• Not here: in button texts and button addresses, or in descriptions (alt texts).
• Only these six: other placeholders, for example from the ticket system, do not work here.

So sieht die Begrüßung aus dem Editor-Beispiel in Discord aus, wenn Lena dem Server beitritt:

• Absender ist der Bot THE GRID. Die Nachricht steht für alle sichtbar im Willkommenskanal – eine Direktnachricht gibt es nicht.
• Platzhalter sind ersetzt: {user} wurde zu @Lena, {username} zu lena_drift, {memberCount} zu 413 und {server} zu PDEL.
• Markdown ist formatiert – anders als in der Vorschau des Editors.
• Link-Buttons sind grau; Discord kennzeichnet sie mit einem kleinen Pfeil. Ein Klick öffnet die Adresse.
• Die Begrüßung bleibt stehen. Der Bot löscht sie nie – auch nicht, wenn das Mitglied den Server wieder verlässt.

This is what the welcome message from the editor example looks like in Discord when Lena joins the server:

• The sender is the bot THE GRID. The message is visible to everyone in the welcome channel – there is no direct message.
• Placeholders are filled in: {user} became @Lena, {username} lena_drift, {memberCount} 413 and {server} PDEL.
• Markdown is formatted – unlike in the editor's preview.
• Link buttons are grey; Discord marks them with a small arrow. A click opens the address.
• The welcome message stays. The bot never deletes it – not even when the member leaves the server again.

Wer die Begrüßung einrichten darf

Welcome Setup bearbeiten können nur der Server-Besitzer und Mitglieder mit der Discord-Berechtigung „Administrator“. „Server verwalten“ reicht nicht. Ohne diese Berechtigung zeigt die Seite „Fehler beim Laden“ mit dem Hinweis „Access denied: admin permissions required“. Mehr dazu unter Voraussetzungen.

Was der Bot im Willkommenskanal braucht

Erteile am besten alle vier – dann ist die Prüfung grün. Hat der Bot die Berechtigung „Administrator“, gelten alle Rechte als erteilt; sonst zählen die Rechte seiner Rollen und die Berechtigungen von Kategorie und Kanal. Nutzt du im Text Emojis eines anderen Servers, kann der Bot zusätzlich „Externe Emojis verwenden“ brauchen.

So erteilst du die Rechte

1. Rechtsklick auf den Willkommenskanal → „Kanal bearbeiten“ → „Berechtigungen“.
2. Füge die Rolle des Bots hinzu – sie heißt in der Regel wie der Bot, „THE GRID“.
3. Erlaube „Kanal ansehen“, „Nachrichten senden“, „Links einbetten“ und „Dateien anhängen“ und speichere.
4. Lade die Welcome-Setup-Seite neu. Bis das Banner grün ist, kann es ein paar Minuten dauern.

Who can set up the welcome message

Only the server owner and members with the Discord permission “Administrator” can edit Welcome Setup. “Manage Server” is not enough. Without that permission, the page shows “Error loading” with the note “Access denied: admin permissions required”. More under Requirements.

What the bot needs in the welcome channel

It is best to grant all four – then the check turns green. If the bot has the “Administrator” permission, all permissions count as granted; otherwise the permissions of its roles and the overrides of the category and the channel apply. If you use emojis from another server in your text, the bot may also need “Use External Emojis”.

How to grant the permissions

1. Right-click the welcome channel → “Edit Channel” → “Permissions”.
2. Add the bot's role – it is usually named like the bot, “THE GRID”.
3. Allow “View Channel”, “Send Messages”, “Embed Links” and “Attach Files” and save.
4. Reload the Welcome Setup page. It can take a few minutes until the banner turns green.

Diese Fehler sind bekannt. Bis sie behoben sind, helfen die beschriebenen Umwege.

Weitere Antworten findest du unter Hilfe & FAQ.

These issues are known. Until they are fixed, the workarounds described here help.

You will find more answers under Help & FAQ.