GD Requests Documentation

What is GD Requests?

GD Requests is a free, hosted platform for Geometry Dash streamers to collect and manage level requests from their community. Instead of managing a chaotic spreadsheet or reading through chat, every request lands in one organised dashboard — complete with status tracking, video embeds, and a public queue page your viewers can check at any time.

It works in two ways:

Getting Started

1. Sign up at gdrequests.org/signup using Google, Discord, or an email and password.
2. Complete the onboarding wizard — set your display name, optional bio, and optionally connect your Twitch or YouTube channel.
3. Share your request link — it's shown at the top of your dashboard. Paste it in your Twitch panels, YouTube description, or Discord server.
4. Watch requests come in — your dashboard updates in real time as viewers submit levels.

Your Dashboard

The dashboard is your control centre. It shows every request submitted to your queue, with the most recent at the top (priority requests always float higher — see Streamer Perks).

Each request card shows:

• Submitter name — who sent the request
• Level ID — the GD level number
• YouTube link — if they included a showcase video, it embeds directly in the card
• Notes — any extra message from the submitter, and which platform it came from
• Viewer presence dot — a green dot means this viewer is still active in your Twitch chat (updates every 10 seconds)
• Priority badge — shown on requests from Twitch subscribers when Priority Queue is enabled

The status filter bar at the top lets you view only Pending, In Progress, Done, or Rejected requests.

Your Request Link

Every creator gets a unique URL in the format:

This is the public page your viewers visit to submit a request. It has two tabs:

• Submit — the form where viewers fill in their name, a Level ID, an optional YouTube showcase link, and any notes
• Queue — a live read-only view of all requests and their current statuses

You can copy and open this link directly from the top of your dashboard. Share it anywhere your community can see it.

Managing Your Queue

Every request can be in one of four states:

To update a status, use the dropdown on any request card and click Update. The change happens instantly with no page reload, and the viewer will see the new status on the public queue page.

To remove a request entirely, click Delete on the card. To clear your entire Pending queue at once, use the Remove All Pending button that appears in the stats bar when you have pending requests.

Queue Popout

The ⧉ Popout button (top-right of your dashboard) opens your queue in a small, independent floating window. You can resize and reposition it anywhere on your screen — keep it in the corner while playing GD so you can manage requests without switching back to the full dashboard tab.

• Click any status tab (Pending, In Progress, Done, Rejected) to filter
• Use the action buttons on each card to change status or delete
• The popout auto-refreshes every 30 seconds
• Works independently — you can close the main dashboard tab and the popout stays open

Bot Settings

The Bot Settings page (found in the nav) is where you connect your Twitch or YouTube channel to the GDRequests bot and configure queue behaviour.

Connecting Twitch

Enter your Twitch username and click Connect. The bot will join your channel on its next refresh cycle (up to 10 minutes). Once connected, any message containing a valid GD level ID or YouTube URL is automatically added to your queue.

Connecting YouTube

Paste your YouTube channel URL, @handle, or channel ID. The bot monitors your live chat during streams and captures level IDs silently (it cannot reply in YouTube chat, but all submissions are saved to your queue).

Queue Settings

Auto-Clear Queue

GD Requests automatically removes old entries to keep your queue clean and database storage in check. You can configure how long each status is kept before it's deleted — found under Auto-Clear Queue in Bot Settings.

How the Chat Bot Works

The bot runs 24/7 as a separate service. Once your channel is connected, it passively watches every message in your chat. It detects two types of submissions automatically:

• Level IDs — any message containing a 6–9 digit number is treated as a GD level request
• YouTube URLs — if Allow YouTube URL Submissions is enabled, posting a youtube.com or youtu.be link adds it as a YouTube showcase request (no level ID required)

The viewer doesn't need to use a command or open a link — they just type in chat and the bot handles the rest:

The bot confirms the submission with a chat message including a link to the queue page so the viewer can track their request status.

Commands Reference

These commands work in your Twitch chat. YouTube chat is read-only — the bot captures level IDs but cannot send replies there.

Streamer Perks

Configure all of these in Bot Settings.

Enable / Disable Requests

The Enable Level Requests toggle is a master switch for your queue. Turn it off to instantly close submissions — the bot will reply to anyone who tries with a "requests are currently closed" message. Turn it back on when you're ready. No need to disconnect the bot.

Only Accept When Live

When enabled, the bot checks if your Twitch channel is live before accepting any submission. If you're offline, the viewer gets a bot reply: "Requests are only open when the stream is live!" — keeping your queue clean when you're not streaming.

Priority Queue

When enabled, requests submitted via Twitch chat by subscribers are automatically marked as priority. Priority requests always appear before non-priority requests in your Pending queue — a great perk to offer subscribers.

Sub-Only Mode

When enabled, only Twitch subscribers can submit via chat. Non-subscribers who post a level ID receive a friendly bot reply: "This channel is in sub-only mode. Subscribe to submit levels!"

Web form submissions are not affected by this setting — it only applies to chat submissions.

Live Viewer Presence

For every request submitted via Twitch, your dashboard shows a coloured dot next to the submitter's name:

• Green — the viewer has been active in your chat in the last 30 minutes
• Grey — the viewer hasn't chatted recently and may have left

The dot updates every 10 seconds on your dashboard, so you can quickly see who's still watching before you start their level.

Submitting a Request (Viewers)

There are two ways to submit a level request to a creator:

Via the request link

1. Open the creator's request link (they'll share it in their Twitch panels, YouTube description, or Discord).
2. Enter your name, a GD Level ID, and optionally a YouTube showcase link and any notes.
3. Click Submit Request. You'll see a confirmation message.

Via Twitch chat

If the creator has the bot connected, just type your level ID anywhere in chat. The bot will confirm your submission and give you a link to check your queue position.

If the creator allows YouTube submissions, you can also paste a YouTube link directly in chat (youtube.com or youtu.be) — the bot will add it as a showcase request.

Checking the Queue (Viewers)

Every creator has a public queue page at:

This page updates in real time and shows all requests with their current statuses. You can see exactly where your request sits and whether the creator has started, finished, or rejected it.

You can also use !queue in Twitch chat and the bot will reply with the direct link.

FAQ