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 or dropdown self-service role menus with access and claim-limit 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: Combine cosmetic roles, tier rewards, tenure and XP requirements, private supporter channels, boost insights, and optional boost announcements.

Community and content

Analytics: Review privacy-conscious message, member, voice, moderation, XP, suggestion, and DISBOARD bump trends.
Messages: Send, schedule, and edit Dolottle-authored messages with embeds, buttons, variables, pinning, 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 rank cards, rewards, and announcements, and publish all-time, weekly, and monthly leaderboards.
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.
Events: Schedule server events with RSVP controls, capacity, reminders, locations, and an optional attendee role.
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, Atom, YouTube, or Twitch 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.
Scheduled Messages: Schedule, edit, cancel, and deliver app-authored messages in the server time zone.
Auto Purge: Delete matching channel messages on a recurring schedule or after a configured age.
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.
Managed Webhooks: Create or synchronize incoming webhooks and safely send, edit, or delete their messages.
Temporary Voice Channels: Create member-owned voice rooms from a join-to-create lobby and remove them when empty.
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, activity, or administrative-change bursts; protect important roles and channels; and alert, quarantine, timeout, or apply a recovery-safe lockdown.
Entry verification: Place new members into a pending role, collect up to five server-defined responses, track a staff-review deadline, and approve or deny entry.
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, /app repair`
Roles	`/role, /role-group, /auto-role, /reaction-role, /approval-role`
Moderation	`/moderate, /case, /verify, /moderation role, /moderation mute-role, /lockdown, /unlockdown`
Tickets	`/ticket, /tickets`
Community	`/suggest, /poll, /event, /giveaway, /qotd, /birthday, /level, /leaderboard, /currency, /store, /games, /tag, /remind, /counting`
Automation	`/message, /automatic-thread, /sticky-message, /feed, /bump-reminder, /logging, /temporary-voice, /voice-room`

Member-facing commands such as /ticket open, /suggest submit, /level, /leaderboard, /tag view, 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.

Role groups can also be referenced in Dolottle-authored text with %group or %{Group Name}. Dolottle resolves the group when it sends the message, so its current roles are shown. Ordinary percentages such as 98%remain unchanged. The message's mention-notification setting determines whether expanded roles are notified or only displayed.

A Role Group can also allow member mentions. Members may then put its reference anywhere in an ordinary message, and Dolottle replies once with the current role mentions without deleting or recreating the member's message. Staff with Manage Server or Mention Everyone can invoke staff-only groups. Multiple groups are deduplicated, and unsafe or unavailable role mentions never notify partially.

Role selectors that support multiple roles list reusable groups first. Command access and giveaway eligibility can treat the expanded selection as either “any selected role” or “all selected roles.”

{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

Safe Tag conditions

Tag responses can conditionally include text when an argument or explicit target is present. For example: {{#if arg1}}Value: {arg1}{{else}}No value.{{/if}}. Checks are limited to args, arg1 through arg10, and target_provided. Conditions cannot be nested and never execute scripts, commands, or network requests.

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 Webhooks and Create Expressions
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.