Documentation

Bottly is a no-code workspace for Discord bots. You design the bot in the browser, connect it with a bot token, and Bottly runs the commands, components and automations for you.

The 5 minute path

Each bot has its own workspace with dedicated tabs:

The left sidebar switches bots; the search field jumps between bots and pages, and the bell icon opens your notification center.

Bottly verifies the token against Discord, encrypts it and stores it server-side. It is never kept in your browser and never sent back to it. If you reset the token in Discord, paste the new one in Bottly — the old one stops working immediately.

The Design workspace pairs an editor with a pixel-accurate Discord preview.

Markdown that works in Discord

# Big heading
## Medium heading
### Small heading
-# Subtext
**bold** *italic* __underline__ ~~strike~~ `code`
> quote

Mentions use ID syntax, not plain text: <#channel_id> for a channel, <@user_id> for a user, <@&role_id> for a role and </name:command_id> for a slash command. A bare # is a heading, not a channel.

A command has a name, description, options, permissions and a response.

Options support string, integer, number, boolean, user, channel, role, mentionable and attachment types. Mark an option required when the command cannot run without it; optional options must come after required ones.

Responses can be:
Ephemeral replies are only visible to the person who ran the command — good for settings, tickets and errors.

Command names must be lowercase, 1–32 characters, no spaces. Discord may take up to an hour to propagate global commands the first time.

Components attach to a message and react to clicks.

Every component gets an action: send a message, assign a role, open a modal, or start an automation. The live preview shows labels, emoji and styles exactly as Discord renders them.

The flow builder connects triggers → conditions → actions.

Common triggers: member joins, message sent, reaction added, button clicked, command run, scheduled time.

Conditions branch the flow: role checks, channel checks, text matching, number comparisons.

Actions: send message, DM the user, add or remove a role, create a channel, add a timeout, call a webhook, wait.

A workflow only runs when it is enabled. Use the Logs tab to see each run step by step, including which condition stopped the flow.

Events run without a command: welcome and goodbye messages, autorole, reaction roles, join logging and boost announcements. Each event has its own channel target and message body.

Presence controls what your bot shows in the member list: status (online, idle, do not disturb) and activity text such as "Playing /help".

The Logs tab records command runs, automation executions and runtime errors with timestamps.

Typical issues:

The marketplace is public — anyone can browse listings without an account. Filter by category, tags and price, or sort by newest, rating, best sellers and price.

A listing page shows the image gallery, price, seller profile with a Verified badge when applicable, a markdown description and reviews.

Buying requires an account and enough balance. If you have a discount code, paste it in the purchase box to see the recalculated price before confirming. After purchase the bot lands in your dashboard.

Purchased bots are locked to appearance edits: you can rebrand the design, but the original command and automation logic stays intact.

Open Marketplace → Publish and pick one of your bots.

A good listing has:
Listings are copies: buyers get a clone, you keep your original. You can unpublish at any time from My listings. Banned accounts cannot publish.

Only buyers can review a listing: 1–5 stars plus an optional comment. The average and review count appear on cards and the listing page. You can edit or delete your own review.

If a listing breaks the rules, use Report on the listing page. Reports go to a moderation queue where the team can hide the listing, resolve or dismiss the report. You get a notification when your report is handled.

Every seller has a public profile at /u/username with their bio, verification badge, sales stats and active listings. Set your username, avatar and bio in Account settings.

Verification is granted manually by the team to creators with a consistent sales and review history.

Your balance is shown in USD next to your avatar. Clicking it opens /balance with the current amount, full transaction history and a top-up box.

Top-ups use codes: paste a balance code and the amount is credited instantly. Purchases, refunds and admin adjustments all appear in the history with a timestamp and description.

Discount codes reduce the price of a marketplace purchase by a percentage. Enter the code on the listing page before confirming; the quote is recalculated server-side, so the shown price is the price you pay.

A code can be limited by number of uses and expiry date, and each account can normally redeem it once.

Plans control how many bots you can run and which features are unlocked. Manage your plan in Billing, where you can also redeem plan codes.

Downgrading keeps your data: bots above the new limit are paused rather than deleted.

The bell in the dashboard header collects sales, purchases, moderation results, balance changes and platform announcements. Unread items are highlighted; opening the panel marks them as read.

Site-wide announcements can also appear as a popup or a top bar when the team publishes something important.

Never share your Discord token in a listing description, screenshot or support message. If you think it leaked, reset it in the Developer Portal and paste the new one in Settings.