> ## Documentation Index > Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt > Use this file to discover all available pages before exploring further. # Appeals > Your server's own appeal page, where punished members ask to have a sanction lifted and your staff accepts, rejects or replies from Discord or the dashboard. ## What it does Every server gets its own appeal page at `petto.sbs/appeal/`. A member signs in with Discord, sees the punishments they have in your server (the ones you allow to show), opens a form and sends an appeal. The staff gets it in a channel with **Accept**, **Reject** and **Reply** buttons, and the member follows their appeal on the page and by DM. Everything starts **off**. A server has no appeals until you turn **Take appeals** on, and the page says "closed" until then. ## Set it up In the dashboard open **Appeals**: **1. Pick where appeals arrive** In **Appeal settings**, choose the channel for appeals and, if you want, a log channel, a thread under each appeal and roles to ping. ![The Where appeals arrive card: appeals in #appeals, the log in #mod-log, Moderators pinged and a thread under each appeal](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-step-1-channel.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=6cd3f91e6c7f1f70506bfa89a3a4a9e5) Dashboard → Appeals → Appeal settings: Where appeals arrive. **2. Make a form** In **Appeal forms**, add sections and questions and set the form to **Live**. ![The Ban appeal form set to Live, blocked for a week when rejected, for bans and softbans, with a single-use invite](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-step-2-form.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=4522ef2a98359232a2399dea7e18bc87) Dashboard → Appeals → Appeal forms: a form opened: its name, icon, status, who can open it and the invite. **3. Open it** In **Appeals**, turn on **Take appeals** and copy the link of your page. The checklist says what is still missing. ![Take appeals checked with the Save button, and Your appeal page with petto.sbs/appeal/pettoland, Copy and Open](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-step-3-open.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=d8aacb897d65ca96349672fb5eea3027) Dashboard → Appeals → Appeals: Take appeals turned on and the link of the page. ![The Appeals page with Take appeals on, the appeal link and the counts of waiting, accepted and rejected appeals](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/moderation/appeals.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=73e536152f0ba2f3ffb59ddfd5224e55) Dashboard → Appeals: the link of the page, the checklist and the appeals by state. Petto needs permission to send messages in the appeals channel (and to create threads, if you use them), **Ban Members** to lift bans and **Moderate Members** to end timeouts. When an appeal is accepted, rejected or withdrawn, Petto locks and archives its thread, so nothing more is written there (this needs **Manage Threads**). When the member cannot be messaged, the staff is told why (DMs closed, or no server in common with Petto); the answer is always on the appeal page. ## A name for your link In **Appeal settings** you can pick a **Link name**, so the page is `petto.sbs/appeal/your-name` instead of the server id. Use 3 to 32 letters, numbers or dashes. The link with the server id keeps working. Names that are only numbers, names that look like Discord, Petto or other brands and names with offensive words are not allowed, and two servers cannot share a name. The sanction messages and `!appeals` use your name when you set one. ![The Link name card with petto.sbs/appeal/ followed by pettoland](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-link-name.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=73dd5c86551750c0044d973e4d032f2e) Dashboard → Appeals → Appeal settings: the link name of the page. ### If you change your name The name you leave stays **reserved for you for 30 days**, so nobody else can take it. During that time the old link redirects to your new address, and the pages you shared keep working. After 30 days the name is free for anyone. The page, the forms and the appeals stay the same: only the address changes. ### If the name is taken If another server already holds the name, Petto offers a **request** for the Petto team. Tell the team why it should be yours (at least 20 characters), add a link to see your server (an invite) and, if you have it, an extra proof such as your website or a social profile. A review takes **from 1 hour up to 72 hours**. While you wait, your page uses the link with the server id, and you can pick another name or cancel the request at any time. You can have one request open at a time. If the team accepts, the other server goes back to its server id link and the name is yours. ![The Ask for this name card for gamenight: why it should be yours, a link to the server, an extra proof and Send request](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-name-request.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=3fba65feb4922cba7f577d6e5af7ca57) Dashboard → Appeals → Appeal settings: the request for a name another server has. ### Names that stop being used A name is freed by itself when Petto leaves the server, when appeals have been off and untouched for 30 days, or when they are on but no appeal arrived and nothing was changed for 90 days. The link with the server id never stops working. ## Forms A form has up to 6 sections with up to 12 questions each. You also choose: | Option | What it does | | - | - | | Who can open it | Leave empty and anyone can. Pick types (ban, mute, warn, kick, softban) and the member needs one of those punishments. | | When it is rejected | Don't block, or block the member from appealing for a day, a week, a month or for good. | | Single-use invite | Gives the member an invite that works once when the appeal is accepted. | | Messages | Your own text for sent, accepted and rejected on this form. | ![Two live forms, Ban appeal and Mute appeal, with their questions and the Edit and Duplicate buttons](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-forms.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=aea4c674e108659dc5914e70d61e59e5) Dashboard → Appeals → Appeal forms: the forms of the server. ### Kinds of question | Kind | What the member sees | | - | - | | Short answer, Long answer | A text box. | | Number | Only numbers. | | Choose one, Dropdown list | One option from your list (2 to 20). The dropdown is better for long lists. | | Choose several | Many options from your list. | | Yes or no | Two buttons. | | Rating scale | Numbers from 1 up to a limit you pick, from 3 to 10, with the lowest and the highest named. | | Date | A date picker. | | Link | A link that starts with `http://` or `https://`. | | Confirmation box | A box to tick, like "I read the rules". If it is required, the form cannot be sent without it. | | File upload | Files from the device, added as they are picked. | ![The Questions card of the Ban appeal: sections with long answers, a choose one list and a rating scale](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-questions.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=3f7d2560797050d1257e66d46e72b585) Dashboard → Appeals → Appeal forms: the questions of a form, each with its kind. **Files.** A file question says what it accepts: **pictures** (PNG, JPG, WEBP or GIF), **PDF**, **pictures or PDF**, or **pictures, PDF or text**, and how many files, from 1 to 5, up to 5 MB each. Petto checks what the file really is, so a program or an archive with a picture name is refused. Pictures are drawn again as PNG, so a GIF becomes a still picture. The member can remove a file before sending, and files never sent are deleted after a day. You read them on the card in Discord and in **Appeal submissions**; the member reads theirs on their appeal page. They are deleted with the appeal when it is removed. A member can have one appeal waiting per form at a time, and can withdraw it. ## Answering The card in your channel is a Components V2 card: the member's picture and name, the state of the appeal, their punishments, every answer, the files they attached (pictures show on the card, up to 10 files and 8 MB in all; the rest are in the dashboard) and three buttons. ![An appeal card that pings Moderators, with the ban, the member's answers and the Accept, Reject, Reply and Dashboard buttons](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=826b99e32ac6e7abd4aecb4cf2b9bdaf) In Discord: a ban appeal as it arrives in the appeals channel. * **Accept** asks for an optional reason, lifts what the member appealed (the ban, the timeout and the active Petto sanctions; a **hardban** is never lifted from here) and sends them the answer and the invite. For a softban there is nothing left to undo in Discord: the case is cleared and the member gets the invite back, the same as an accepted ban appeal. * **Reject** asks for an optional reason, writes to the member and applies the block the form asks for. * **Reply** writes to the member without deciding. They get it by DM and on their page, and can answer if you allow replies. > [accordion] Accept > > ![The Accept this appeal window with the reason the member will see](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-accept-modal.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=9f239f6df93c915e1f79e83650c09c92) > > In Discord: Accept asks for an optional reason. > > ![A DM from Petto: your appeal was accepted, the reason, the invite to rejoin and the link of the appeal page](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-accepted-dm.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=1d3b04ba2543638f5f35458d505dbe2a) > > In Discord: the DM the member gets, with the invite and the link of their appeal. > [accordion] Reject > > ![The Reject this appeal window with the reason the member will see](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-reject-modal.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=180f630f0b922a22dedbfdafdbdf15f4) > > In Discord: Reject asks for an optional reason. > > ![A DM from Petto: your appeal was rejected, with the reason and the link of the appeal page](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-rejected-dm.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=6f85c1b1b023c9125a5f4605600e44e4) > > In Discord: the DM the member gets. > [accordion] Reply > > ![The Reply to the member window with a question for the member](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-reply-modal.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=b3b92468c09b8bfbed6e00945ecace42) > > In Discord: Reply asks for the message. > > ![A DM from Petto: the staff of Petto Land wrote to you, the message of kira and the link to answer](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-reply-dm.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=036fc126292e7a8160f5e9150ac610cc) > > In Discord: the DM the member gets, with the link to answer on the page. Once an appeal is accepted, rejected or withdrawn, the buttons stay on the card but are **locked**, and the card says who answered and when, so nobody answers twice. The same actions are in **Appeal submissions** in the dashboard, with the answers, the punishments and the whole conversation. If the member has DMs closed, they still read everything on the page. ![The appeal card marked Accepted with the invite, Accepted by kira and the reason, its buttons locked, and the private answer Appeal accepted, lifted ban 128](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-card-answered.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=b8858c0d948c4f76d6151828f8ded0d9) In Discord: after Accept the card is locked and says who answered; kira sees what was lifted. ![The waiting appeal of spammer opened, with the ban, the answers, the conversation with kira and the Accept and Reject buttons](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-submissions.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=04e9a7c5b629c5a193fb6cd6eca092e3) Dashboard → Appeals → Appeal submissions: an appeal opened: punishments, answers, the conversation, Accept and Reject. ## What the member sees You decide it in **Appeal settings**: * which punishment types show and can be appealed: bans, mutes, warns, kicks and **softbans** (from `!softban` or the [Honeypot](https://wiki.petto.sbs/moderation/honeypot.md)), each one on or off. Softbans start off. * which details show: reason, duration, moderator. Petto punishments also show their case number. * where punishments come from: Petto, Discord (native bans and timeouts) or both * how long warns and softbans count (older ones are not shown) * a greeting at the top of the page and the language it opens in (the member can switch it) * **Wait before appealing**: the hours a member waits after their latest punishment before they can appeal, from 0 (no wait, the default) to 720. Until then the page says from when they can appeal and the forms stay locked. ![The What the member sees card with bans, mutes, warns and softbans checked and a 24 hour wait](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-member-sees.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=54f15dec0d66cc1630e435d0fcf2eb58) Appeal settings → What the member sees: softbans can be appealed, and members wait 24 hours. ![The public appeal page of Petto Land with a ban, a Ban appeal form and a locked Mute appeal form](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeal-page.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=9abfc6d0c6b643fefb66633e6fc35fec) The appeal page a member sees after signing in: their punishment and the forms they can open. ![The Ban appeal form on the appeal page: long answers, a choose one question, a rating scale, yes or no, a file upload and a confirmation box](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-form-page.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=57002dfe25e70c35814fec0f3d3fe5a5) The form the member fills in, one section after the other. ![The page of a waiting Ban appeal with the messages of Petto, kira and the member, a box to write and Withdraw appeal](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-status-page.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=32d1e75082dba4e5c93c69de83be69c8) The page of a sent appeal: its state, the conversation with the staff and the answers. ## Brand and link preview **Appeal brand** makes the page yours: the name, a tagline, a banner, an icon and an accent color. It also controls **how the link looks when it is pasted in Discord**: title, description, image and side color, with a live preview. Banners and images must use HTTPS. ![The Appeal brand page: name, tagline, banner, icon and accent color, then the link preview with its title and description](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-brand.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=3c716163583cbf1037af7b7e4a01d465) Dashboard → Appeals → Appeal brand: the page and how its link looks in Discord, with the preview. **Pictures.** The banner, the icon and the picture of the link preview can be **uploaded from your device** (PNG, JPG, WEBP or GIF, up to 5 MB; a GIF is saved as a still picture) or taken from a link. Allowed links are direct links to a picture that start with `https://` and belong to a public site, like `i.imgur.com`. Links with `http://`, addresses of numbers, `localhost`, private networks and pages that are not a picture (an Imgur album, a Google Drive page) are not allowed, and Petto tells you which link was rejected. Links to Discord attachments stop working after a while, so it is better to upload the picture. ## Messages **Appeal messages** sets what the member reads when the appeal is sent, accepted, rejected and when the staff writes. You can use `{username}`, `{server}`, `{reason}`, `{form}` and `{link}`. ![The Appeal messages page with the variables and the sent, accepted, rejected and staff messages, each with a preview](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-messages.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=6a1dd3d770e6744df059e0faad10b251) Dashboard → Appeals → Appeal messages: each message with its preview. ## Sanction DMs When appeals are on, the DM a member gets when they are punished can point to your appeal page. This covers every sanction DM: moderation commands, AutoMod, anti-scam, the [Honeypot](https://wiki.petto.sbs/moderation/honeypot.md) and warn escalation. In **Appeal settings → Sanction DMs** you choose: Like every DM from Petto, this one starts with a grey `From ` line and has info, delete and report buttons: see [DMs from Petto](https://wiki.petto.sbs/moderation/dms-from-petto.md). * **Send the appeal link**: **always** (the default: for the sanctions members can appeal), **never**, or **only for the sanctions I pick** among bans, temporary bans, softbans, kicks, timeouts and mutes, and warns. * **Your line about appeals**: your own sentence instead of Petto's "Think this is a mistake? Appeal here", up to 300 characters. `{link}` is the appeal link (added at the end if you leave it out) and `{server}` the name of the server. Empty goes back to Petto's sentence. ![A DM from Petto: you have been banned from Petto Land with the reason, the line of the server and petto.sbs/appeal/pettoland](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-sanction-dm.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=1c75836b048bbffdff1cf5c20335571b) In Discord: a ban DM with the server's line and the appeal link. ![The Sanction DMs card with the link sent only for bans and softbans and a custom line](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/moderation/appeals-sanction-dms.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=761fd2fa6f142170d38680163439a94f) Appeal settings → Sanction DMs: the link only for bans and softbans, with the server's own line. Custom sanction messages are not changed, but you can put the link in them with [`{case.appeal}`](https://wiki.petto.sbs/resources/scripting/variables). It follows the same rule: it is empty when appeals are off or that sanction gets no link. ## The appeals command `!appeals` shows the appeal link of your server, how many appeals wait for an answer and the settings below. With a setting and a value it changes it. It needs **Manage Server**. ```javascript Syntax theme={null} !appeals !appeals types !appeals dmlink !appeals note !appeals wait ``` ```javascript Example theme={null} !appeals types ban, mute, softban !appeals dmlink ban, tempban, softban !appeals note Read the rules first, then appeal at {link} !appeals wait 24 ``` > [accordion] !appeals > > ![kira runs appeals: the link petto.sbs/appeal/pettoland, 3 waiting for an answer and the four settings](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-command.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=da2298035f7b954fd44a4c38f04cb0e1) > > In Discord: the link of the page, the appeals waiting and the settings. > [accordion] !appeals types > > ![liam sets the types to ban, mute and softban and Petto shows the saved settings](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-command-types.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=926a12665d0f053fccf8eb646610a330) > > In Discord: bans, mutes and softbans can be appealed. > [accordion] !appeals dmlink > > ![liam sets dmlink to ban, tempban and softban and Petto shows the saved settings](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-command-dmlink.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=bdced25314fc955522c06a4f4affbcf1) > > In Discord: the link only in the DMs of bans, temporary bans and softbans. > [accordion] !appeals note > > ![liam sets a line with the link variable and Petto shows it in the settings](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-command-note.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=02cf375cc592f823bd7d9b421f5e7e19) > > In Discord: your own line in the sanction DMs. > [accordion] !appeals wait > > ![liam sets the wait to 24 hours and Petto shows the saved settings](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/moderation/appeals-command-wait.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=12d8cf4435ddd9d7e6d535b67c12a01a) > > In Discord: 24 hours of wait before appealing. | Setting | What it changes | | - | - | | `types` | The punishments members see and can appeal: `ban`, `mute`, `warn`, `kick`, `softban`. `off` for none. | | `dmlink` | Whether sanction DMs carry the link: `always`, `never`, or a list of `ban`, `tempban`, `softban`, `kick`, `timeout`, `warn`. | | `note` | Your line about appeals in sanction DMs, with `{link}` and `{server}`. `off` goes back to Petto's sentence. | | `wait` | Hours to wait after the latest punishment before appealing, 0 to 720. `off` for no wait. | ## The invite for accepted members If you turn on **Make a new single-use invite for each accepted appeal** (or the same option in a form), Petto makes an invite that works once and lasts 7 days. The invite that was made is shown on the appeal card in Discord, in the log and in the appeal in the dashboard. If Petto cannot make one (it needs **Create Invite** in a text channel) it says why and sends the invite code from the settings instead, if you set one. ![The Accepted appeals card with Make a new single-use invite checked and answered appeals kept for 3 months](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/moderation/appeals-invite.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=f86c381ce4c5979da4185fc486e6f4d9) Dashboard → Appeals → Appeal settings: Accepted appeals: the fixed invite code, the single-use invite and how long appeals are kept. ## Privacy and keeping data * Members sign in with Discord. Petto reads who they are and nothing more, and a member only sees their own appeals. * Answered appeals are deleted after the number of days you choose (7 by default). **Delete all appeal data** in Settings removes forms, appeals, messages and settings at once. * You can hide the name of the moderator when they write. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.