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.

Add a Report to Your Website

Open the tournament’s Reports tab and choose the report, section, and round you want to publish. Reports must already be available on the public tournament page.
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. Copy any reportType, section, and round parameters from the report address you selected.
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 for visitors using screen readers. The report and section selectors are omitted, so choose what visitors see through the URL. 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. Omitted, invalid, or repeated values use `system`. 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.

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

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.
Your website editor removes the iframe: use its HTML/embed block or ask the website administrator to allow iframes from https://chessroster.com.