Server Listings — List Your Server

The owner-side flow for adding your server to the public directory — the Server Listing page in the guild dashboard, every form field explained, and what happens when you save. Free for every Mokito server.

Overview

As the owner of a Discord server that Mokito is in, you can list that server on Mokito's public directory. The listing is a card in the browse grid plus a detail page, both driven by what you fill in on the Server Listing page in your guild dashboard. The page is free — there is no Premium tier and no paid placement.

The Server Listing page lives in the guild dashboard sidebar, alphabetically between Roles and Steam Games. Open it, fill in the form, click Save listing at the bottom, and your server appears on the directory immediately.

Who can edit a listing

Only the server owner — the Discord user who owns the guild — can edit the listing. Managers and Mokito admins can open the page and see the current state, but every field is locked and the save button is hidden. This keeps listing control with the one person who owns the server.

The Server Listing page

The page is one long form, organized into widgets. Each widget covers one part of the listing. The save button is at the very bottom — there is no sticky bar and no save button at the top, so scroll to the bottom to commit your changes.

Listing status

The first widget is a single checkbox: Enabled. This is the on/off switch for your listing.

If your listing is enabled and has been live, a small "Listed since <date>" line appears under the toggle so you can see when it went live.

Invite URL *

This is the only required field. Paste a permanent Discord invite link for your server. Mokito accepts two formats:

• https://discord.gg/<code>
• https://discord.com/invite/<code>

The https:// prefix is optional — you can paste discord.gg/yourserver bare and it will be accepted. Mokito parses the invite code out of the URL and uses it as both the listing's slug (the detail-page URL is /servers/<code>) and the Join button link. Only discord.gg and discord.com/invite URLs are accepted — no other redirect services.

Short description

A plain-text summary of your server, up to 200 characters. This is shown on the browse grid card (truncated to two lines) and on the detail page header if no long description is set. Keep it punchy — this is the first thing a visitor reads.

Long description (Markdown)

The full description for your detail page, up to 2000 characters. Markdown is supported — headings (#, ##, ###), bold, italics, bulleted (-) and numbered (1.) lists, links, blockquotes (>), and code blocks. The description renders as formatted HTML on the detail page with Mokito's dark-neon styling.

Tags

You can attach up to 5 tags to your listing. Tags help visitors filter the directory — clicking a tag on a card or the detail page takes the visitor to the browse grid filtered to that tag.

The tag picker has two parts:

• Curated dropdown — a list of pre-defined tags (community, gaming, anime, roleplay, creative, identity, activity, tech, and more). Select one to add it as a chip.
• Custom input — type your own tag and press Enter (or click Add). The tag is slugified and added as a chip. If another owner has already used the same custom tag, your listing reuses that tag — custom tags are shared across the directory.

Tags appear as chips above the picker. Click the × on a chip to remove it. Duplicate tags (case-insensitive) are rejected. The 5-tag limit is enforced — you will see a "Maximum 5 tags" toast if you try to add a sixth.

Primary language

A short language code for your server's primary language — e.g. en for English, es for Spanish, fr for French. Up to 8 characters. This is shown as an uppercase code on the detail page and is filterable on the browse page (the language dropdown lists every language code any listing has set).

NSFW self-declare

A checkbox to mark your server as NSFW. If your server is adult-oriented, tick this. NSFW listings are hidden from the default browse view — a visitor has to explicitly opt into NSFW to see them.

Social links

Six optional URL fields, each validated against the provider it belongs to:

Leave any field blank to omit it. Filled-in links appear as labeled buttons with the provider's icon in the "Links" row on the detail page.

Banner image

An optional banner image shown across the top of your listing card and the detail-page header. Upload constraints:

• Formats: PNG, JPG, WebP, or GIF.
• Max size: 1 MB.
• Rendering: The banner is cropped with object-fit: cover, so a wide image (roughly 3:1 on the card, 5:1 on the detail page) looks best.

Upload is AJAX — choose a file, click Upload, and the banner is stored and previewed immediately. You do not need to save the form for the banner to stick. Removing the banner is a two-step confirm — click Remove banner, a modal asks you to confirm, and the banner is deleted. If no banner is uploaded, the card and header show a gradient placeholder with the server icon faded in.

Saving + auto-publish

The Save listing button sits at the very bottom of the form. Clicking it commits all field changes in one request. There is no separate "publish" step — when you save with the listing enabled, your server is immediately visible on the directory. This is the auto-publish model: no approval queue, no waiting period.

If a listing is reported and a Mokito admin decides it violates the directory rules, the admin can hide or remove it. A hidden listing disappears from the directory but can be re-published by the admin; a removed listing is taken down entirely. You will still be able to see and edit your listing from the Server Listing page regardless of its moderation state.

The read-only view

If a manager or Mokito admin opens the Server Listing page, they see the same form but every field is disabled and the save button is hidden. A banner at the top reads: "Only the server owner can edit this listing. You can view the current state below." This lets managers and admins see what the listing looks like without being able to change it.

Limits & Edge Cases