Frequently Asked Questions

Where are my puzzles saved?

By default, puzzles are stored in the cloud and can be accessed from any online computer. However, it is possible to save puzzles locally in the persistent storage provided by your browser. To do this, select 'Save As' from the File menu and check the 'Store locally' box in the resulting dialog. Note that when this option is used, you can only access puzzles from the browser in which they were saved and that if you clear your browser's cache, the puzzles are lost for good.

Where are my word list edits saved?

Changes to word scores and sample clues are all stored locally in persistent storage provided by your browser. This means these changes are only accessible using the browser in which the edits were made. However, it is possible to export your word list at any time. If you are using the app to tweak your word list we recommend that, for backup purposes, you periodically export your word list to a safe location on your computer. Your exported word lists can then be imported on any computer/browser.

What are acceptable word list formats?

Word lists can be unscored or scored. An unscored word list is just a text file where each line contains a word list entry. Entries can only include alphanumeric characters; Special characters are not allowed. For scored lists, each line would consist of a word and a number separated by a semi-colon, comma, or tab.

Words can also contain sample clues that are displayed when showing the results of fill operations. In the default word list included with this app, most entries have a sample clue. Sample clues can be included in a word list by adding a third component to each line. So, for a scored word list with sample clues, each line would consist of an entry, a number, and a sample clue with these items being separated by a semi-colon, comma, or tab.

How are word scores used?

Scores are primarily used to sort lists of slot options. Higher scored entries, which presumably correspond to better fill options, are shown first. It is also possible to set minimum score filters when searching for fill. These filters can be set globally for the entire grid or at the slot level.

How can I modify word scores?

Any place in the app that you see a word score, whether it be in the lookup tab or slot option lists, you can simply click on the existing score and enter a new value. These edits are applied immediately and will persist within the browser where the edits were made.

What's up with the default word list?

Most of the entries (≈ 93%) in the default word list come from puzzles that have appeared online. We've been downloading puz files for years and cleaning the results, removing punny or otherwise inappropriate answers. This dataset is used by the lookup tool to provide sample clues and word occurrence statistics. The remaining entries came from some miscellaneous sources including a word frequency list based on a corpus of scrapped internet content as well as some manual additions.

The three-, four- and five-letter words have all been manually scored. The criteria used for scoring is as follows:

80Sparkle, i.e. longish, in-language words and phrases, or well known/topical proper nouns
50Solid English words or phrases and well known proper nouns
30Words that are acceptable, but less than ideal, e.g. word derivatives, common crossword entries, etc.
10Cruddy words often needed as glue to make the grid work, e.g. partials, abbreviations, foreign words, etc.
5Words to be avoided at almost all costs, e.g. esoteric words, Roman numerals, weird abbreviations, etc.

Scoring for words that are six-letters or longer is a bit of a hodgepodge. Some of them have been manually scored, but the majority have been given a score (in the range of 5 to 50) based off their occurrence counts. While using occurrence counts to score words can lead to some flawed results (overestimating long-established crosswordese and underestimating fresh, new entries), it does provide some means of sorting a long list of slot options.

Obviously, word scoring is subjective. One person's crud could be completely acceptable to someone else. If you don't agree with how a particular word is rated, you are free to change it. Just click on the score that is shown in either the Fill pane or the Lookup pane, and enter a new value. This change will be saved to persistent local storage in your browser.

To see which version of the default list you have stored locally, click "Default word list info" from the Word Lists menu. From there, you can also download the latest version of the list. New words are added and scoring edits are made almost daily, so feel free to refresh frequently. And don't worry about losing any local score edits. Any changes that you might have made to the default list word scores will not be lost during a refresh.

Is there a way to add more than one block at a time?

Yes there is. If you click on multiple squares while holding down the control key (or for Mac users, the command key), the app will select those squares. You can then perform bulk operations on them, such as toggle block, toggle circle, or toggle shaded square.

How can I see the top candidates list for a particular slot?

If you right-click on a square in the grid, it will bring up a context menu that, in general, will show the top 10 candidates for both the across and down slots containing the square. The exception is when a slot is completely unfilled. In that case, the context menu will just include the number of candidates from your word list that match the slot length.

Is there an easy way to add an item from a slot option list to the grid?

Yes. When viewing slot option word lists, either in the Fill pane or a context menu, there are two actions that can be initiated with the mouse. A single click will look the word up in the clue database and display the results, while a double click will add the word to the grid.

What do the colored slots mean?

When you open up the fill tab, the app performs lookups on each slot based on the characters currently in the grid. If there are 10 or fewer candidates, the slot will be highlighted in yellow. If there is a single option, the slot is highlighted in yellow and the sole candidate is shown in grey. And if there are no candidates, the slot is highlighted in red.

These colors are intended to show you the constrained and unfillable slots, although it is important to note that these colors are based on candidates, not valid options. You can only tell if a candidate is valid by performing a fill operation.

What does a greyed out letter mean?

If the app has identified that there is only one letter option for a particular square, it will show that letter in grey. To accept all the "single-option" letters shown in the grid, use the keyboard shortcut Alt + Shift + Enter. If you just want to accept the options being shown in the active slot, use Shift + Enter.

How can I fill just one region of the grid?

For many grids, the black squares and the completed slots break up a puzzle into multiple isolated regions in which the fill can be tackled independently. You can control which region is filled by changing the active slot on the grid before starting a new fill operation. If that slot has unfilled squares, the application will limit the search to the region containing that slot. On the other hand, if the active slot is completely filled in, or a black square is selected, the application will attempt to fill the entire grid.

What browsers does this work with?

The app has been tested in the latest desktop versions of Chrome, Firefox, and Edge. It is not mobile friendly at the moment, and there have been some problems reported with Safari (specifically, clue editing). Also, it uses some browser features released in the last year, so if you have not updated your browser in a while, you might encounter some issues.

The app also does not work in private windows on Firefox. The technology used to store word lists, indexedDB, does not function in that mode of browsing. By the way, for those concerned about privacy issues, Crosserville does no advertising nor uses third-party cookies of any kind. We only use cookies to maintain login state and to save puzzles and word lists locally.

This app is almost perfect, but it's missing one key feature. Could I make a suggestion?

Of course! We love suggestions here at Crosserville and have added many user-proposed features to the app. If there's something you'd like to see implemented, send a message to and we'll see what we can do.