# FluxerList Docs

> Guides, references, and release notes for FluxerList, the community directory for Fluxer servers, bots, themes, and self-hosted instances.

Beta 0.3.11 · Now with self-hosted instance listings

# Get your community found on Fluxer

FluxerList is the community directory for Fluxer. These docs show you how to list a server, bot, theme, or instance, grow it with bumps and votes, and build on the API.

Quickstart

How it works

What's new

Scroll

<path d="M6 9l6 6 6-6" />

**The path**

## Three steps to a busier community

[01 **List**Submit your server, bot, theme, or instance and pass review. ](/quickstart)

[02 **Grow**Bump every 12 hours, collect votes, and take the Spotlight. ](/bumps-and-votes)

[03 **Build**Sync your stats and reward voters straight from code. ](/api-quickstart)

**01** List

## Start with what you're listing

Every listing type has its own review process. Read the guide before you submit and you'll skip the most common rejections.

#### [Servers](/servers)

Content standards, the three content ratings, and what gets a listing removed.

#### [Bots](/bots)

Requirements, the five review stages, and the privacy disclosures every bot needs.

#### [Self-hosted instances](/instances)

Health checks and the DNS TXT record that proves you own your domain.

#### [Descriptions](/markdown)

Tables, task lists, highlights, and emoji for your long description.

**02** Automate

## Bring FluxerList into your server

#### [Meet the bot](/fluxerlist-bot)

Bump, vote, and track activity with short commands.

#### [Command reference](/bot-commands)

Every command, with aliases and who can run it.

#### [The casino](/bot-casino)

19 games that wager your FL Tokens, with the real odds.

**03** Grow

## Grow once you're live

[<path d="M7 17L17 7M8 7h9v9" /><path d="M8.5 14.5A2.5 2.5 0 0 0 11 12c0-1.38-.5-2-1-3-1.07-2.14-.22-4.05 2-6 .5 2.5 2 4.9 4 6.5 2 1.6 3 3.5 3 5.5a7 7 0 1 1-14 0c0-1.15.43-2.29 1-3a2.5 2.5 0 0 0 2.5 2.5z" />](/bumps-and-votes)

**6****7** day streak  +5 FL

**1****2****3****4**

***1,204*

***1,187*

***1,090*

****Your server**Bump#1

****************

Bumps and votes

Climb the listings and build a bump streak.

[<path d="M7 17L17 7M8 7h9v9" />](/spotlight)

********

<path d="M12 2.5l2.9 6.1 6.6.8-4.9 4.6 1.3 6.6L12 17.3l-5.9 3.3 1.3-6.6L2.5 9.4l6.6-.8L12 2.5z" />

Spotlight

Buy 24 to 72 hours at the top.

[<path d="M7 17L17 7M8 7h9v9" />](/flat)

Live FLAT**** **

<defs>
  <linearGradient id="fl-area" x1="0" y1="0" x2="0" y2="1" />
</defs><path d="M0 66 C20 60 30 44 50 48 S80 26 100 30 S132 14 160 10 L160 80 L0 80 Z" fill="url(#fl-area)" />

**

FLAT score

Show your community is active right now.

[<path d="M7 17L17 7M8 7h9v9" />](/tokens)

FL FL FL *+5**+10*

FL Tokens

Earn them for votes, bumps and quests.

[<path d="M7 17L17 7M8 7h9v9" /><path d="M6 9H4.5a2.5 2.5 0 0 1 0-5H6" /><path d="M18 9h1.5a2.5 2.5 0 0 0 0-5H18" /><path d="M4 22h16" /><path d="M10 14.66V17c0 .55-.47.98-.97 1.21C7.85 18.75 7 20.24 7 22" /><path d="M14 14.66V17c0 .55.47.98.97 1.21C16.15 18.75 17 20.24 17 22" /><path d="M18 2H6v7a6 6 0 0 0 12 0V2Z" />](/awards)

******

************

Community awards

Six silver-shine recognitions for servers and members.

[<path d="M7 17L17 7M8 7h9v9" />](/upgrades)

<path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" /><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" />

fluxerlist.com/invite/yourname

<path d="M8.5 14.5A2.5 2.5 0 0 0 11 12c0-1.38-.5-2-1-3-1.07-2.14-.22-4.05 2-6 .5 2.5 2 4.9 4 6.5 2 1.6 3 3.5 3 5.5a7 7 0 1 1-14 0c0-1.15.43-2.29 1-3a2.5 2.5 0 0 0 2.5 2.5z" /><path d="M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z" /><path d="M9 8.2a.8.8 0 1 0 0 1.6.8.8 0 0 0 0-1.6z" /><path d="m21 15-3.09-3.09a2 2 0 0 0-2.82 0L6 21" /><path d="M12 2.5l2.9 6.1 6.6.8-4.9 4.6 1.3 6.6L12 17.3l-5.9 3.3 1.3-6.6L2.5 9.4l6.6-.8L12 2.5z" /><polygon points="13 2 4 14 11.5 14 10.5 22 20 10 12.5 10 13 2" /><path d="M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8" /><path d="M3 3v5h5" />

Listing upgrades

Vanity invites, flame badges and custom backgrounds.

**04** Build

## Build on FluxerList

#### [API quickstart](/api-quickstart)

Get a key and make your first request.

#### [Sync your server count](/sync-server-count)

Keep your bot's listing accurate from code.

#### [Reward your voters](/reward-voters)

Pull your voter list and thank them with a role or perk.

### Something missing or wrong?

The FluxerList team and community hang out in the support server. Drop in and ask.

Join the community

Read the FAQ

> Guides, references, and release notes for FluxerList, the community directory for Fluxer servers, bots, themes, and self-hosted instances.

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.fluxerlist.com/_mcp/server

## Docs

- [Welcome to the guides](https://docs.fluxerlist.com/guides.md): Everything you need to list, grow, and build on FluxerList.
- [How FluxerList works](https://docs.fluxerlist.com/how-it-works.md): The four listing types, the review process, and the pieces that decide where you rank.
- [Quickstart](https://docs.fluxerlist.com/quickstart.md): Get a server listed, then set it up so it gets discovered.
- [Submit a server](https://docs.fluxerlist.com/servers.md): How to list your community, and how review works from submission to going live.
- [Add a server, step by step](https://docs.fluxerlist.com/add-a-server.md): A walkthrough of the Add Listing form, from the top bar to Submit for Review.
- [Submit a bot](https://docs.fluxerlist.com/bots.md): What reviewers check, the five review stages, and how to get approved faster.
- [List a self-hosted instance](https://docs.fluxerlist.com/instances.md): Pass the health check, prove you own the domain, and get listed next to servers, bots, and themes.
- [Format your description](https://docs.fluxerlist.com/markdown.md): Every Markdown feature FluxerList supports in long descriptions, with copy-paste examples.
- [Community Guidelines](https://docs.fluxerlist.com/community-guidelines.md): The conduct rules, content ratings, and enforcement process that apply across every listing type on FluxerList.
- [Server Guidelines](https://docs.fluxerlist.com/server-guidelines.md): Content ratings, disclosure requirements, and what gets a server listing removed.
- [Bot Guidelines](https://docs.fluxerlist.com/bot-guidelines.md): Data disclosure requirements and what gets a bot listing rejected or delisted.
- [Instance Guidelines](https://docs.fluxerlist.com/instance-guidelines.md): What gets a self-hosted instance listing rejected or delisted.
- [The FluxerList bot](https://docs.fluxerlist.com/fluxerlist-bot.md): Bump, vote, track activity, earn tokens, and list your server without leaving Fluxer.
- [Command reference](https://docs.fluxerlist.com/bot-commands.md): Every public FluxerList bot command, its aliases, and who can run it.
- [Set up the bot for your server](https://docs.fluxerlist.com/bot-setup.md): Pick a prefix, choose where commands work, and decide what your members can do.
- [List your server from chat](https://docs.fluxerlist.com/bot-list.md): File a FluxerList listing with a guided form, without leaving Fluxer.
- [Notifications](https://docs.fluxerlist.com/bot-notifications.md): Get bumps, votes, and listing updates posted in a channel you pick.
- [Earn tokens with the bot](https://docs.fluxerlist.com/bot-tokens.md): Daily check-ins, odd jobs, quick minigames, and activity rewards you can claim without leaving chat.
- [The casino](https://docs.fluxerlist.com/bot-casino.md): 19 games that wager FL Tokens, how to bet, and what the odds really are.
- [Bot troubleshooting](https://docs.fluxerlist.com/bot-troubleshooting.md): Fixes for the messages and problems people hit most with the FluxerList bot.
- [Bumps and votes](https://docs.fluxerlist.com/bumps-and-votes.md): The two everyday ways to climb the listings, and how bump streaks work.
- [Spotlight and featured slots](https://docs.fluxerlist.com/spotlight.md): Pay with FL Tokens for a time-limited spot at the top, and what happens when every slot is taken.
- [Listing upgrades](https://docs.fluxerlist.com/upgrades.md): Vanity invites, flame badges, custom backgrounds, and page layouts, unlocked per server with FL Tokens.
- [Community awards](https://docs.fluxerlist.com/awards.md): Six silver-shine recognitions for the servers and people who make Fluxer better.
- [Partners](https://docs.fluxerlist.com/partners.md): What FluxerList Partners get, who qualifies, and how to apply.
- [Partner requirements and applying](https://docs.fluxerlist.com/partners/requirements.md): What staff look for, how to apply, and how to check where your application stands.
- [Enhanced Analytics](https://docs.fluxerlist.com/partners/enhanced-analytics.md): The dashboard view of votes, members, ratings, and comments for partner servers.
- [Earn and spend tokens](https://docs.fluxerlist.com/tokens.md): Every way to earn FL Tokens, what they buy, and how gifting and the monthly leaderboard work.
- [Check-ins, quests, and referrals](https://docs.fluxerlist.com/quests.md): The three recurring ways to earn FL Tokens without spending any.
- [The shop and Whale Vault](https://docs.fluxerlist.com/shop.md): Cosmetics, badges, and boosts you can buy with FL Tokens, and the exclusive tier unlocked at 10,000.
- [FLAT activity score](https://docs.fluxerlist.com/flat.md): Fluxer List Activity Tracking, a live measure of how active a community is right now.
- [What counts and how it moves](https://docs.fluxerlist.com/flat/signals.md): The signals behind a FLAT score, and how it rises and fades.
- [Privacy and opting out](https://docs.fluxerlist.com/flat/privacy.md): What FLAT sees, how long it keeps it, and how to turn it off.
- [API quickstart](https://docs.fluxerlist.com/api-quickstart.md): Get an API key and make your first authenticated request in a few minutes.
- [Find your listings](https://docs.fluxerlist.com/find-your-listings.md): Look up the account an API key belongs to, and the bots or servers it owns or manages.
- [Sync your bot's server count](https://docs.fluxerlist.com/sync-server-count.md): Post your bot's guild count to FluxerList on a schedule so the number on your listing stays honest.
- [Check a vote](https://docs.fluxerlist.com/check-a-vote.md): Look up whether a specific Fluxer user currently has an active vote for your bot or server.
- [Reward your voters](https://docs.fluxerlist.com/reward-voters.md): Page through everyone who voted for your server or bot and thank them in your community.
- [Embed a stat badge](https://docs.fluxerlist.com/stat-badges.md): Drop a live server count, member count, or vote count badge into a README or website - no API key required.
- [RSS and Atom feeds](https://docs.fluxerlist.com/feeds.md): Follow new server listings in any feed reader, or pull them into your own tools.
- [FluxerTools](https://docs.fluxerlist.com/fluxertools.md): The tools, bots, and libraries for Fluxer communities that FluxerList is part of.
- [Tools and projects](https://docs.fluxerlist.com/fluxertools/tools.md): What FluxerTools offers besides FluxerList.
- [The FluxerTools badge](https://docs.fluxerlist.com/fluxertools/badge.md): The amber badge on some server listings, and what it does and doesn't mean.
- [FAQ](https://docs.fluxerlist.com/faq.md): Quick answers about browsing, listing, bumping, FLAT, and your account.
- [Support](https://docs.fluxerlist.com/support.md): Where to get help, report problems, and reach the team.
- [Earlier releases](https://docs.fluxerlist.com/release-archive.md): Highlights from Beta 0.2.0 through Beta 0.3.3, before dated release notes began.
- [API overview](https://docs.fluxerlist.com/overview.md): Base URL, authentication, pagination, and errors for the FluxerList API.
- [Changelog](https://docs.fluxerlist.com/changelog.md)
- [Changelog (all entries)](https://docs.fluxerlist.com/changelog/llms.txt)

## API Docs

- Endpoints > Bots [Update a bot's server count](https://docs.fluxerlist.com/api/endpoints/bots/update-bot-stats.md)
- Endpoints > Bots [Get a bot](https://docs.fluxerlist.com/api/endpoints/bots/get-bot.md)
- Endpoints > Voters [Check a user's vote status for a bot](https://docs.fluxerlist.com/api/endpoints/voters/check-bot-vote.md)
- Endpoints > Voters [Check a user's vote status for a server](https://docs.fluxerlist.com/api/endpoints/voters/check-server-vote.md)
- Endpoints > Voters [List a server's voters](https://docs.fluxerlist.com/api/endpoints/voters/list-server-voters.md)
- Endpoints > Voters [List a bot's voters](https://docs.fluxerlist.com/api/endpoints/voters/list-bot-voters.md)
- Endpoints > Widgets [Bot stat badge](https://docs.fluxerlist.com/api/endpoints/widgets/get-bot-widget.md)
- Endpoints > Widgets [Server stat badge](https://docs.fluxerlist.com/api/endpoints/widgets/get-server-widget.md)
- Endpoints > Servers [Get a server](https://docs.fluxerlist.com/api/endpoints/servers/get-server.md)
- Endpoints > Users [Get the current user](https://docs.fluxerlist.com/api/endpoints/users/get-me.md)
- Endpoints > Users [List the current user's bots](https://docs.fluxerlist.com/api/endpoints/users/get-my-bots.md)
- Endpoints > Users [List the current user's servers](https://docs.fluxerlist.com/api/endpoints/users/get-my-servers.md)
- Endpoints > Bumps [Get a server's bump status and history](https://docs.fluxerlist.com/api/endpoints/bumps/get-server-bumps.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.fluxerlist.com/openapi.json)
- [OpenAPI YAML](https://docs.fluxerlist.com/openapi.yaml)