Dolottle guide

Build the server workflows your community actually needs.

This guide covers installation, everyday configuration, commands, message variables, permissions, and the major tools available in Dolottle.

Getting started

Add Dolottle to your server.Use dolottle.app and choose Add Dolottle to Discord. You need permission to add apps to the destination server.
Place the Dolottle role.Move it above every ordinary role Dolottle must grant, remove, customize, or use for moderation. Discord-managed roles cannot be assigned by bots.
Open the dashboard.Sign in with Discord, select the server, and review its readiness and permission results before configuring features.
Configure one workflow at a time.Most new entries start enabled. Dolottle reports missing required fields or permissions instead of saving a partially usable feature.

Good first checks

Run /app status for a current permission and installation report. Run /app review-permissions after reviewing the result.

Features

Each feature keeps its own configuration and activity while sharing Dolottle’s role, channel, message, authorization, audit, and delivery systems.

Roles and onboarding

Auto Roles and Sticky Roles: Grant join roles and optionally restore eligible roles when a member returns.
Reaction Roles: Offer normal, binding, verify, single-choice, removal, and limited-selection reactions.
Role Selection: Create button-based self-service role menus with role access controls.
Approval Roles: Grant one or more roles through staff quorum or deterministic automatic validation.
Role Groups: Reuse named collections anywhere Dolottle accepts multiple roles.
Supporter Benefits: Let eligible subscribers and Server Boosters customize or reclaim a solid, two-color gradient, or holographic managed role, review boost insights, and publish optional per-boost announcements.

Community and content

Analytics: Review privacy-conscious message, member, voice, moderation, XP, suggestion, and DISBOARD bump trends.
Messages: Send and edit Dolottle-authored messages with embeds, link buttons, variables, and mention controls.
Welcome and farewell: Publish server-specific arrival and departure messages or welcome DMs.
Levels and XP: Award message or voice XP, apply role multipliers, configure level rewards and announcements, and publish a server leaderboard with XP and currency tabs.
Currency and games: Configure a server currency, channel access, wallet and bank balances, private member transaction history, interest, secured or unsecured loan products, recurring claims, transfers, staff adjustments, a combined-wealth leaderboard, wagered games, and fishing collections.
Store: Sell or gift server-defined inventory, Discord-role rewards, or reusable benefits with wallet currency, stock and per-member limits, staff-reviewed inventory redemption, private member history, durable fulfillment, and audited refunds.
Suggestions and Starboard: Collect member ideas, staff decisions, voting, and community highlights.
Polls: Create single-choice or multiple-choice polls with anonymous voting, scheduled closing, and live or final results.
Tags: Create prefixed custom commands with member arguments, variables, rich messages, and buttons.
Triggers: Respond to text or role events and optionally apply permission-checked role actions.
Feeds and bump reminders: Publish RSS or Atom updates and schedule DISBOARD bump reminders.
Counter channels: Create display-only voice or text channels for live member, role, boost, and server-resource counts.
Personal reminders: Create one-time or repeating reminders with private listing and cancellation.
Voting: Open Dolottle’s Top.gg voting page with the public `/vote` command.
Counting: Run a persistent channel count using numbers or safely parsed mathematical equations.
Question of the Day: Schedule a rotating question bank with optional discussion threads.
AFK status: Let members mark themselves away with optional reasons and expiration.
Birthdays: Privately save a month and day for announcements, or opt in to a year for server-configured age-range roles.
Fun commands: Flip a coin, roll bounded dice, choose from a list, or ask the magic eight ball.

Automation and operations

Tickets: Create private ticket types, panels, intake forms, support workflows, transcripts, retention rules, and closed-ticket actions.
Automatic Threads: Open and optionally validate threads created from qualifying channel messages.
Sticky Messages: Keep a text or embed message visible, with optional buttons and lifetime limits.
Media Channels: Allow selected attachment, image, video, link, embed, sticker, text, or app-command traffic.
Logging: Route selected message, member, role, channel, voice, invite, and moderation events.
Portable configuration: Export and import supported settings with explicit channel and role mapping.

Moderation and safety

Human moderation: Warn, note, apply or remove timeouts, mute, kick, ban, unban, change member nicknames, purge recent messages, and control channel slowmode with content-free audits.
Cases and appeals: Attach notes, links, or Discord-hosted evidence and review member-submitted appeals.
Lockdowns: Lock one channel or the server and restore the permission states Dolottle changed.
Automated moderation: Filter blocked terms, invites, links, mention spam, and repeated text.
Raid protection: Detect join or activity bursts and alert, quarantine, or timeout affected members.
Permission reviews: Audit live and installation permissions and record recurring owner reviews.

Commands

Discord shows the exact options and descriptions as you type. Administrative commands require Manage Server or a configured Dolottle administrator or moderator role.

Area	Command namespaces
Setup and diagnostics	`/app status, /app dashboard, /app review-permissions`
Roles	`/role, /role-group, /auto-role, /reaction-role, /approval-role`
Moderation	`/moderate, /case, /moderation role, /moderation mute-role, /lockdown, /unlockdown`
Tickets	`/ticket, /tickets`
Community	`/suggest, /poll, /qotd, /birthday, /level, /leaderboard, /currency, /store, /games, /tag, /remind, /counting`
Automation	`/threads, /sticky, /feed, /bump-reminder, /logging`

Member-facing commands such as /ticket open, /suggest submit, /level, /leaderboard, /tag show, and /remind remain available according to each server’s configuration.

Message variables

Variables are replaced when Dolottle sends the message. Availability depends on the feature because a ticket number, level, or bumper does not exist in every workflow.

{server}Current server name

{user}Relevant member mention

{username}Relevant member username

{user_id}Relevant member Discord ID

{invoker}Member who ran a tag command

{invoker_username}Tag invoker display name

{invoker_id}Tag invoker Discord ID

{channel}Current channel mention

{args}Complete text after a tag invocation

{arg1} … {arg10}Individual tag arguments, including quoted phrases

{member_count}Current server member count

{ticket_type}Ticket type name

{ticket_number}Formatted ticket number

{support_role}Ticket support role mention

{answers}Submitted ticket intake answers

{level}Member’s current level

{xp}Member’s current XP

{bump_role}Configured bump reminder role

{next_bump}Relative time until the next bump

The dashboard shows feature-specific variables beside the relevant composer. Variables also work in supported embed text and button labels.

Voting for Dolottle

Use /voteto open Dolottle's Top.gg voting page. Voting is optional and a verified vote grants 100 currency units per vote weight in each mutual server where currency is enabled.

Voting is an application-wide Dolottle feature and has no server dashboard settings. Servers cannot configure separate vote rewards, XP, roles, or reminders.

Permissions and intents

Dolottle does not request Administrator. Its installation lists the individual permissions needed by the features it provides.

Common message access

View Channels and Read Message History
Send Messages and Embed Links
Manage Messages and Add Reactions
Mention Everyone for configured non-mentionable role notifications
Create, send in, and manage threads

Feature management

Manage Roles and Manage Channels
Manage Server and View Audit Log
Manage Nicknames
Moderate, Kick, and Ban Members

Message Content and Guild Members are privileged intents used for configured message workflows, Auto Roles, Sticky Roles, member events, supporter benefits, moderation mutes, and raid protection. A successful /app status response confirms the live Gateway connection and identifies missing server or installation permissions. Dolottle also audits both permission surfaces regularly.

Troubleshooting

A configured role mention does not notify members

Confirm the message allows role notifications and that Dolottle has Mention Everyone in the destination channel. Discord suppresses notifications for non-mentionable roles when that permission is unavailable.

Dolottle cannot assign or remove a role

Confirm Manage Roles is present and move the Dolottle role above the target role. Roles managed by Discord or another integration cannot be assigned manually.

A channel or message is missing from a selector

Confirm Dolottle can view the channel, then refresh after its channel catalog synchronizes. Message editors can load only supported messages the app is allowed to inspect.

A feature will not enable

Complete its required channel, role, message, or policy fields. The dashboard returns the toggle to off and explains the missing requirement.

A moderation or ticket action failed

Check Dolottle’s permission audit, channel overwrites, and role position. Failed administrative actions remain auditable rather than silently disappearing.

Still stuck? Contact support@dolottle.app.