Embedding Tournament Reports

Show a ChessRoster report inside your club or tournament website. The embedded version includes a small Powered by ChessRoster link and the report itself, without site navigation or tournament administration controls. Visitors can read the report and open player details without signing in.

Copy the Embed Code

The quickest way is to let ChessRoster write the code for you, so the embed shows exactly what you had on screen:

Open the tournament’s Reports tab and set up the view you want to publish — the report, the section, the round, and any columns you turned on or off under Customize display.
Choose Share at the top of the tournament page, then Embed this report.
Pick a color scheme, and switch on any of the title, the controls, or the report’s notices that you want visitors to see. The preview updates as you choose.
Choose Copy snippet and paste it into your website’s HTML or custom-embed block.

The Embed this report dialog: the Light, Dark, Match viewer, and Legacy color schemes, and switches for the title, the controls, and the report's notices

You do not need to sign in, and you do not need to be the organizer. Reports must already be available on the public tournament page.

Write the Embed Code Yourself

You can also build the address by hand — useful when you want to generate embeds for many tournaments at once.

Find the tournament’s unique ID in its ChessRoster address. If your public address uses a short tournament slug, use the ID from its tournament management address instead—the value after /tournaments/ and before /manage.
Replace TOURNAMENT_ID in the example below, and add whichever parameters from the table further down you need.
Paste the HTML into your website’s HTML or custom-embed block.


<iframe
  src="https://chessroster.com/embeddable/tournament/TOURNAMENT_ID/reports?reportType=team-standings&amp;section=0&amp;theme=light"
  title="Tournament team standings"
  width="100%"
  height="800"
  style="border: 0"
  loading="lazy"
></iframe>

Set a height that fits your page; longer reports scroll inside the frame. Give each iframe a descriptive title attribute for visitors using screen readers.

By default the embed shows the table alone — no heading, no selectors, no downloads — so the view you choose in the address is the view visitors get. Add title=1, controls=1, or notices=1 to bring those back. When a table is wider than the frame, More columns and Previous columns let visitors reveal the remaining data with a pointer or keyboard. Phones use compact player cards where supported.

Use the unique tournament ID for new embeds. Older slug-based embed links still work when that slug identifies exactly one tournament. The canonical address is /embeddable/tournament/TOURNAMENT_ID/reports; adding /embed to a normal report address does not create an embedded view.

Choose the Report and Appearance

Add these parameters after ?, separating them with & in a browser address or & in HTML:

Parameter	Values and behavior
`reportType`	`standings`, `standings-summary`, `registration`, `wall-chart`, `pairings`, `current-pairings`, `alphabetical-pairings`, `team-standings`, `club-standings`, or `master-list`. Omit it to use the tournament’s saved default, or individual standings when no default is saved.
`section`	Zero-based section number: `0` is the first section, `1` is the second. Omit it to use the saved default section, or the first section. All Players (`master-list`) spans all sections.
`round`	For All Pairings (`pairings`), use a round number such as `2`, or `all` for every round. Alphabetical Pairings uses a single round and defaults to the latest paired round. Reports without round selection ignore this parameter.
`theme`	`light` fixes a light appearance; `dark` fixes a dark appearance; `system` follows the visitor’s device preference; `legacy` uses the old SwissSys report viewer’s appearance. Naming any of the four settles the appearance, so `light` and `dark` also switch the legacy look off, even on a tournament whose organizer made Legacy their saved default. Omitted, invalid, or repeated values follow the visitor’s device and leave the legacy look to the tournament’s saved default. This setting does not change the visitor’s saved ChessRoster theme.

Team and club reports require the corresponding data in the selected section. Use Reading Tournament Reports for details about each report and the player detail view.

Show More Than the Table

Each of these is off unless you ask for it, so an address with none of them shows the table on its own. Use 1 to switch one on.

Parameter	What it adds
`title`	The Reports heading and the “Updated …” time.
`controls`	Everything visitors can operate: the section selector, the report tabs, the round selector, search, and the CSV and PDF downloads. Leave it off to pin the embed to one view.
`notices`	The report’s own explanatory lines — its description, the tie-break order, the “score order only” warning, and the “a new round is up” banner.

Choose the Columns

The embed follows the tournament’s saved report defaults unless you name a column yourself. Naming even one column switches the embed to the standard defaults plus your choices, so the embed keeps looking the same even if the organizer changes their saved defaults later.

Use 1 to show a column and 0 to hide it: showId, showPost, showTeam, showState, showClub, showFederation, showAge, showGrade, showPrize, showByes, showSex, showFlag, showBoard, showPairNums, showBorders, and fideFormat. Add density=compact, standard, or comfortable to change the row height.

Not every column applies to every report — see Reading Tournament Reports for which report shows what.

The Legacy Appearance

theme=legacy reproduces the appearance of the report viewer ChessRoster replaced: a black header row, cream and gray banded rows, and navy serif names and ratings. It is the same data and the same columns — only the styling differs — and it looks the same whether or not your visitors prefer dark mode.

On the wall chart it also restores the old notation, where each round cell shows the player’s color and their opponent’s pairing number (B 18) and the result is read from the running score underneath. Hovering or tapping a cell still shows the result, the opponent’s name, and the running score in full.

You can also switch this on for yourself on the normal Reports tab: the Legacy view switch sits above the report tabs, next to the Customize display button. Your choice is remembered on that device, so you only set it once — and it carries across tournaments, and across organizer web addresses. Organizers can make it the default for everyone visiting their tournament with Set as Default; a visitor who turns it off keeps it off for themselves.

An embed never inherits a visitor’s own preference, and it follows the tournament’s saved default only when its address names no color scheme. Choosing Light or Dark in the dialog — or writing theme=light or theme=dark yourself — turns the legacy look off for that embed even on a tournament that defaults to it.

Examples

Individual standings matching a light website:


https://chessroster.com/embeddable/tournament/TOURNAMENT_ID/reports?reportType=standings&section=0&theme=light

Team standings from the second section, always dark:


https://chessroster.com/embeddable/tournament/TOURNAMENT_ID/reports?reportType=team-standings&section=1&theme=dark

Round 2 pairings, following the visitor’s device preference:


https://chessroster.com/embeddable/tournament/TOURNAMENT_ID/reports?reportType=pairings&section=0&round=2&theme=system

A wall chart in the old report viewer’s appearance:


https://chessroster.com/embeddable/tournament/TOURNAMENT_ID/reports?reportType=wall-chart&theme=legacy

Standings with a heading, where visitors can switch section and round themselves:


https://chessroster.com/embeddable/tournament/TOURNAMENT_ID/reports?reportType=standings&title=1&controls=1

Standings without the post-event rating column:


https://chessroster.com/embeddable/tournament/TOURNAMENT_ID/reports?reportType=standings&showPost=0

Troubleshooting

The frame is empty or unavailable: open its src address directly and verify the tournament ID and public report availability. A short slug that matches more than one tournament must be replaced with the unique ID.
The wrong section or report appears: start from the public Reports tab, make your selection, and copy its query parameters. Section numbering starts at 0.
The colors do not match your website: choose theme=light or theme=dark. system follows the visitor’s device, rather than the surrounding site’s colors.
A column appeared or disappeared on its own: an embed with no column named in its address follows the tournament’s saved report defaults, which the organizer can change. Name the columns you care about in the address — or rebuild the embed from Share → Embed this report, which names them for you.
theme=legacy still looks light for visitors who prefer dark mode: that is intended. The legacy appearance reproduces one specific historical look and is the same in both modes.
The embed shows the legacy appearance when you did not ask for it: its address names no theme, so it follows the tournament’s saved default, which is set to Legacy. Add theme=light, theme=dark, or theme=system — or rebuild the embed from Share → Embed this report, which names the scheme for you.
A parameter seems to be ignored: check its spelling and its value. An unrecognized parameter, or a value the report cannot use, falls back to the default rather than showing an error.
The Embed option is missing from Share: it appears on the Reports tab, and only once the tournament has reports to show.
Your website editor removes the iframe: use its HTML/embed block or ask the website administrator to allow iframes from https://chessroster.com.