# Server Listing

> **Click** [**here**](https://discord.com/oauth2/authorize?client_id=1069423090225918082\&permissions=275146722545\&integration_type=0\&scope=applications.commands+bot\&redirect_uri=https%3A%2F%2Fcommunityone.io%2Fdashboard%2Fbot-auth-complete%2F%3Fsource%3Dgitbook\&response_type=code) **to introduce our bot to your server.**

### Getting Started

To customize your server listing, visit your dashboard:

```ruby
https://communityone.io/dashboard/[YOUR_SERVER_ID]/
```

Select the server you want to edit and follow the sections below.

### 📋 Setup Checklist

* [ ] &#x20;Write a compelling server description (markdown/CSS optional)
* [ ] &#x20;Select primary language(s)
* [ ] &#x20;Mark as NSFW if applicable
* [ ] &#x20;Choose primary category
* [ ] &#x20;Add 2-3 secondary categories
* [ ] &#x20;Add relevant tags
* [ ] &#x20;(Optional) Add social media links
* [ ] &#x20;Choose analytics visibility preference
* [ ] &#x20;(Optional) Connect announcement channel
  * [ ] &#x20;Verify it meets public + read-only requirements
* [ ] &#x20;(Optional) Enable Discord events sync
* [ ] &#x20;Review visibility settings
* [ ] &#x20;Save and publish!

### 📝 Basic Information

#### Server Description

Write a clear, compelling description of your server. This is one of the most important factors for discoverability.

**Formatting Options:**

* ✅ **Markdown** - Bold, italics, lists, links
* ✅ **CSS** - Custom styling for a unique look
* ✅ **Plain text** - Simple and straightforward

**Pro tip:** Use formatting to highlight what makes your server special!

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2F8lwfAACY0a5ZoHkDsXoZ%2Fimage.png?alt=media&#x26;token=89a333c5-1d47-47bf-842e-5daa59ed59b5" alt=""><figcaption></figcaption></figure>

#### Language Settings

Select the **primary language(s)** your server uses. This determines which regions discover your server.

**Important:** If you select a language, your server will *only* appear in searches for that language.

**Example:**

* If your server is 50% Japanese and 50% English, select both languages
* If you only select Japanese, English-speaking users won't find you
* Choose languages that match your actual community

#### NSFW Content

If your server contains **NSFW content**, you *must* mark it as such.

⚠️ **Warning:** If your server is NSFW and unmarked, we reserve the right to remove it from the platform without notice.

### 🏷️ Categories

#### Primary Category

Choose one primary category that best describes your server. You will show up when the user clicks on that category

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2FHAQEi7CoPCTCmXSOm3u7%2Fimage.png?alt=media&#x26;token=733a55c6-5057-4191-8e7f-a8624d4bc5b0" alt=""><figcaption></figcaption></figure>

#### Secondary Categories

Create custom secondary categories specific to your server. Press **Enter** to add each one.

**Examples:**

* Valorant players
* Pixel art community
* Japanese learners
* Indie game dev

These help users find exactly what they're looking for and improve your discoverability.

### 🔍 Search & Discovery

#### Server Description (Most Important!)

Your description is the **#1 factor** in how users find you. When AI search launches, it will analyze your description to match users with relevant servers.

**Write for:**

* Clarity about what your server offers
* Keywords people might search for
* Your server's unique value

#### Tags & Content

Tags are considered in our ranking algorithm. As AI search improves, we'll introduce **secondary tag search** to give tags more weight in discovery.

**Current approach:** Mix detailed descriptions + relevant tags for best results

### 🔗 Social Links

Add your community's social presence to help users connect with you beyond Discord.

**Supported links:**

* Website/Portfolio
* Twitter/X
* YouTube
* Twitch
* Instagram
* TikTok
* Other social platforms

Users can click these links directly from your listing page.

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2Fdhrk5qAcnJJQVV8DgBNC%2Fimage.png?alt=media&#x26;token=8ec47307-5723-4c67-8a0a-6d6291ad983a" alt=""><figcaption></figcaption></figure>

### 📊 Analytics Visibility

#### Default View (Enabled)

By default, your listing shows public analytics including:

* 📈 Online members
* 👥 Total members
* 🔥 Daily active users
* 💬 Messages per user
* 🛡️ Active moderators

This transparency builds trust with potential members.

#### Private View (Disabled)

If you prefer privacy, **disable analytics visibility**. Instead of exact numbers, potential members will see:

* Ranges instead of exact counts
* General activity indicators
* No specific member data

**Toggle in:** Visibility Settings → Analytics Visibility

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2F0QPb6YFKuLfvT9bakK5v%2Fimage.png?alt=media&#x26;token=b3b41636-8c98-4db5-aa9a-d184484a597e" alt=""><figcaption></figcaption></figure>

***

### 📢 Announcement Channel Sync

Let us automatically publish your server's announcements to your listing page, giving potential members a live view of your activity.

#### Setup Requirements

**Before we sync your announcement channel:**

1. ✅ **Channel must be announcement-focused**
   * Used primarily for announcements, news, updates
   * Not a general chat channel
2. ✅ **Channel must be publicly viewable**
   * Accessible to new members or the public
   * Internal staff channels are **not allowed**
3. ✅ **Regular members: Read-only access**
   * Members can view announcements
   * Members **cannot** write/post in the channel
   * Only mods/admins can post

**Verification Timeline:** We verify channels within **1 business day**

#### How It Works

Once approved, your announcement channel automatically syncs to your listing, showing potential members:

* Recent updates and news
* How actively you manage the server
* Real community activity

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2FFihavO6I4npcJhCMLpSv%2Fimage.png?alt=media&#x26;token=cd58435c-9b11-4e2c-be1c-a389c91a8ec5" alt=""><figcaption></figcaption></figure>

### 🎉 Discord Events Sync

Enable us to display your Discord events on your listing page. This gives members a reason to join—they can see upcoming events before joining!

#### Event Management

You have full control over which events display:

**Show events from:**

* Selected channels
* All public events

**Hide events from:**

* Blacklisted channels
* Cancelled/suspended events

**How to manage:**

* Toggle individual events on/off
* Blacklist specific channels if needed
* Events from blacklisted channels won't appear on your listing

#### Why This Matters

Users specifically browsing our **Events Discovery page** can find your server based on activities like:

* Game nights
* Movie nights
* Tournaments
* Community events

Active event hosting = more visibility + more members

### 👁️ Visibility Settings

#### Make Your Server Public (Default)

Your server appears in search results and browsing.

#### Hide from Listing (Private)

**Toggle:** Visibility Settings → Public Server

If disabled:

* ❌ Won't appear in search results
* ❌ Won't show in category browse
* ❌ Only visible via direct link
* ❌ Won't appear in events discovery

Use this if you want to keep your server invite-only or private.

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2Fedjj4ScpSPA529OVk9Q0%2Fimage.png?alt=media&#x26;token=09179530-d8fc-4ffe-8cc1-e59b492e36f7" alt=""><figcaption></figcaption></figure>

### ❓ Common Questions

**Q: Can I change my server listing after setup?**\
A: Yes! Go to your dashboard anytime to edit any information.

**Q: How long until my announcement channel is verified?**\
A: Usually within 1 business day. You'll receive a notification when approved.

**Q: What if my server is private but I want to use listings?**\
A: Keep your server public in the listing settings, but restrict invites in Discord. New members see your listing before they need an invite code.

**Q: Can I hide specific events?**\
A: Yes! You can toggle individual events on/off or blacklist entire channels.

**Q: Will my analytics data be accurate?**\
A: Yes, if visibility is enabled. Data updates regularly. If you disable visibility, you'll see ranges instead.

###

{% hint style="info" %}
Join [Discord](https://discord.gg/nVqt3z78Mw) for questions, comments, and a little gift <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f381/512.gif" alt="🎁" data-size="line">  or back to [CommunityOne Home](https://communityone.io/)
{% endhint %}

\\
