Your club ladder, inside your Discord server

The Club Ladder app keeps your ladder in a channel and edits it as members' Lichess and chess.com ratings change. It gives rating roles, runs leagues, announces your team's tournaments and posts a weekly recap.

Set up in three steps

  1. Add the app

    Anyone with Manage Server can add it.

  2. Run /setup

    Pick "A ladder" in the channel you want and paste the ladder's link.

  3. Members run /link

    Their ratings join the ladder and their roles follow.

What members see

Picture: a Discord message listing the standings of The Candidates with each player's blitz rating and an arrow for the 30-day change.

The standings message. It edits itself as ratings change.

Picture: a Discord message headed "The Candidates: last week" naming the most improved and most active players.

The weekly recap, on the day and hour you set. Ladder games add the biggest upset and the longest win streak.

Live public ratings of well-known players, over the last 30 days, laid out the way the app posts a ladder.

  • Standings that keep up

    One message per ladder, edited when ratings move. Results can post as they are recorded.

  • Rating roles

    A role for each rating band, in the time control you pick, updated as linked members' ratings change.

  • Tournament posts

    Follow your Lichess team or chess.com club: new events, a reminder before the start and the podium after.

  • A daily puzzle

    Posted at your hour with a Solve button. Members solve privately and can share a result that hides the answer. Today's puzzle.

Commands

For everyone

  • /linkLinks a Lichess or chess.com account, once. /link remove deletes the link and everything kept about that member.
  • /profileShows a member's ratings from both sites side by side, with recent change, and compares two players.
  • /standingsShows the ladder, or a board: most improved, biggest upset, win streaks, most games, biggest climbers.
  • /puzzleThe server's daily puzzle, unlimited training at your level, a streak run, or a famous game moment. Solving is private.
  • /helpLists the commands.

For organizers

  • /setupAsks one question: a ladder, tournament posts, rating roles or a league for this channel.
  • /leagueSign-ups, divisions by rating, one thread per pairing, results read from Lichess and chess.com, promotion and relegation at season end, team matches.
  • /adminSettings, ladder posts, tournament follows, rating roles, seasons and game downloads.

Right-click a member for "Chess profile", or a message for "Show board".

Questions

Do we need a ladder on the website first?

Yes. The ladder is made on the Start page from your Lichess team or chess.com club link, with no account. The app then posts it in a channel. If you paste a team or club link into /setup, the app sends you to that page with the link filled in.

Do members need a Club Ladder account?

No. A member runs /link once. Lichess members sign in with Lichess; chess.com members add a short code to their profile.

What does the app read?

Slash commands and button presses only. It does not read messages or send direct messages, and it mentions only the roles you pick for announcements.

What does it cost?

One ladder, one league, rating roles, tournament posts, the weekly recap and puzzles are free. The Club pass, $22 a year, adds more ladders and leagues in one server, challenges to other clubs, automatic alternates and rival notices.

Which permissions does it ask for?

Send messages, embed links and read message history to post and edit the standings; manage webhooks for ladder and tournament posts; manage roles for rating roles; create and manage threads for league pairings. Turn off any you do not want; the feature that needs it says so.

No Discord server?

The web ladder shows the same standings on a page your members open. Free for small clubs.