Skip to Content
SwissSys IntegrationHow ChessRoster and SwissSys Work Together

How ChessRoster and SwissSys Work Together

ChessRoster and SwissSys each handle a distinct part of running a rated chess tournament. This page explains what each system does, how data moves between them, and what extra features become available when the two are connected.

What Each System Does

ChessRoster is the web platform. It handles:

  • Online player registration and payment collection
  • Public tournament listings and schedules
  • Real-time results and standings visible to players and spectators
  • Organizer profiles and tournament management pages

SwissSys is Windows desktop software. It handles:

  • Generating pairings each round (Swiss, round-robin, and other formats)
  • Entering and tracking game results
  • Submitting rated events to USCF, CFC, or FIDE
  • Producing printed reports and wall charts

Neither system does everything alone. ChessRoster makes your tournament visible online and simplifies registration. SwissSys runs the mechanics of the event.

The Typical Workflow

Create a tournament on ChessRoster

Set up the event online so players can find it and register. ChessRoster collects player information, federation IDs, and section preferences.

Download registrations into SwissSys

Once registration opens (or at any point before the first round), download the player list from ChessRoster as an SJSON file and import it directly into SwissSys. Player names, federation IDs, and ratings are ready to go — no re-entry needed.

Run the tournament in SwissSys

Use SwissSys on your Windows computer to generate pairings, enter results round by round, and manage the event.

Sync results back to ChessRoster

After each round — or at the end of the event — SwissSys automatically pushes your tournament data to ChessRoster (v11.76+). Players and spectators see current standings online in real time.

Submit ratings

Use SwissSys to submit the event for rating through USCF, CFC, or FIDE as required.

What Data Moves Between the Systems

DataDirectionHow
Player registrations (name, federation IDs, section)ChessRoster → SwissSysSJSON file download
New/withdrawn/updated registrations during the eventChessRoster → SwissSysRegistration event messages (polled by SwissSys)
Pairings and resultsSwissSys → ChessRosterAuto-sync (v11.76+) or manual file upload
Tournament standingsSwissSys → ChessRosterAuto-sync (v11.76+) or manual file upload

Registration events (coming soon): SwissSys polls ChessRoster for registration changes — new players, withdrawals, section moves — so your desktop software stays in sync without manual imports mid-tournament. This feature is under active development.

Live View

When SwissSys syncs pairings and results to ChessRoster, your tournament’s live view updates automatically. The live view is a TV-optimized display that rotates through tournament data — suitable for a monitor at the venue or sharing online.

The live view can show:

  • Tournament Leaders and Section Standings — current scores
  • All Pairings and Section Pairings — board assignments
  • Round Progress — games completed per section
  • Recent Results — a feed of latest outcomes
  • Biggest Upsets — notable results ranked by rating-point difference

Additional features:

  • Players can follow their games on their phones without crowding the pairing board.
  • Spectators see standings update as results come in.
  • The live view URL can be displayed at the tournament or shared on social media.

Live view is enabled automatically when SwissSys syncs to ChessRoster. No extra configuration is needed.

Pairing Notifications

ChessRoster can send SMS text messages to players when round pairings are posted. Players opt in during registration. When SwissSys uploads pairings for a new round, registered players receive a text with their board number and opponent.

This reduces the need for directors to make announcements and helps players who step away from the playing hall.

Who Needs SwissSys?

You need SwissSys if you are:

  • Running USCF-rated, CFC-rated, or FIDE-rated events
  • Managing tournaments with Swiss-system or round-robin pairings
  • A tournament director who needs round-by-round pairing and result-entry tools

You may not need SwissSys if you are:

  • Running unrated casual events
  • Using ChessRoster’s built-in tournament management without desktop pairings

SwissSys is Windows-only software. Mac users can run it using virtualization software such as Parallels Desktop , though this configuration is not guaranteed to work on every setup. See system requirements  for details.

How the Connection Works

SwissSys connects to ChessRoster through a one-time account linking process. Once linked, SwissSys authenticates as you and can communicate with ChessRoster’s API automatically. The session lasts six months before re-linking is needed.

For details on establishing the connection, see Linking Your Account.

Last updated on
See something that needs updating? .