NSA Home Page

Submitting Ratings Data

The NSA requires that tournament directors submit the results of their tournaments electronically through this web site, and no longer accepts data on floppy disk or in printed form.

If you are using a program such as tsh or TourneyMan to run your tournament (and you should, given that they're freely available and vastly simplify the work involved in running an event), then you probably already have your tournament data ready in the right format:

tsh users TourneyMan users
Use the “SUBMIT” command. Use the “Save for Chew” menu to save a file, and upload it to the ratings data validator as explained below.

If you are using a program not listed above, please ask the program’s author to contact John Chew to post instructions here.

If you want to prepare your data file by hand, please prepare a text file in the format described below. (We also support two legacy formats, as well as a richer format more suitable for automatic generation by software.) If you're saving your text file with a modern version of Microsoft Word, make sure it's set to save it in ASCII or the so-called “US-ASCII” rather than Unicode.

Here is an annotated example of a data file, followed by a detailed explanation.

#division A
#ratingcheck off
Chew, John 1800 3 0 2 3 0 2; 300 50 350 300 50 300
Edley, Joe 2000 0 3 1 0 3 1; 50 300 350 0 300 400
Butts, Alfred 500 1 2 0 1 2 0; 400 400 50 400 400 50
#division B
Doe, John 1500 3 0 2 3 0 2; 300 50 350 300 50 300
Doe, Jane 1400 0 3 1 0 3 1; 50 300 350 50 300 400
Doe, Kate 1300 1 2 0 1 2 0; 400 400 50 400 400 50
#division C
Sherman, Joel 2000 3 0 2 3 0 2; 300 50 350 300 50 300
Wapnick, Joel 2000 0 3 1 0 3 1; 50 300 350 50 300 400
Horn, Joel 1800 1 2 0 1 2 0; 400 400 50 400 400 50

If there is data for more than one division in the data file, each new division should begin with a line that consists of '#division', a space, and the division name.

If the input ratings in the data file to not match the currently posted NSA ratings, adding the line '#ratingcheck off' will suppress error messages.

The player data for each division must appear on consecutive lines. Spaces must be inserted where described below, and additional spaces may be added between syntactic elements for clarity or aesthetics. Each line begins with a player's last name, a comma, a space, the player's first name, a space, and the player's input rating (or 0 for previously unrated players). After this come a list of pairing numbers indicating who the player played in each round, from the first round to the last. A pairing number of 0 indicates that the player had an unrated bye or forfeit; a pairing number of n means that the player's opponent was the nth player listed in the division. After the pairing numbers comes a semicolon and the player’s scores in each round, again from the first to the last. If a player had a bye or forfeit, the score should be the player’s spread for that round, typically +50 or -50.

When your file is ready, please submit it to us using our ratings data validator, which will check it for syntax errors and then send it to Joe Edley for ratings computations.

At the end of the submission, you will be redirected to the rating fee payment form, a link to which is given here in case the fee is to be paid by someone other than the person responsible for the data. Please note that ratings data submitted more than two weeks after the last day of a tournament are subject to a late fee of $0.25 per person.


HASBRO is the owner of the registered SCRABBLE® trademark in the United States and Canada. © 2011 HASBRO. All rights reserved. "SCRABBLE® Brand Crossword Game" is the proper way to refer to this unique group of word games and related properties marketed by HASBRO. "SCRABBLE®" is not a generic term. To use it as such is not only misleading but also does injustice to the company responsible for the trademark's longtime popularity. All we ask is that when you mean SCRABBLE® Brand Crossword Game, you say so. 

The SCRABBLE® trademark is owned by J.W. Spear and Sons, PLC, a subsidiary of Mattel, Inc. outside of the United States and Canada. 

For more information about SCRABBLE® or the NSA, or to comment on or correct the contents of this page, please e-mail: info@scrabble-assoc.com. 
For information about SCRABBLE® tournaments please visit our partner organization, NASPA. To report technical difficulties in reading this page,  please contact webmaster John Chew at: poslfit@gmail.com