Crossword Puzzle Generator

Introduction

A crossword puzzle is a clue-driven word grid where answers run across and down and shared letters help confirm each other. That interlocking structure is what makes crosswords satisfying to solve and useful to build around a theme, whether the subject is classroom vocabulary, a club night, a staff social, or a custom handout tied to one event.

This generator takes that familiar format and rebuilds it around your own answer-and-clue list. Instead of starting from a fixed puzzle bank, you supply the entries, choose how hard the page should search for a good fit, and then review the numbered grid, clue lists, quality metrics, attempt log, unused entries, and JSON snapshot from the winning run.

That workflow is most useful when the vocabulary itself matters. A teacher can build a revision puzzle from lesson terms, an organiser can turn themed facts into a table activity, and a team can make a custom puzzle for one meeting instead of relying on a generic newspaper grid.

The important caveat is that this page helps you build practical custom crosswords, not editor-reviewed publication puzzles. Classic American-style construction usually expects 180 degree symmetry, no two-letter answers, and every letter to belong to both an Across and a Down entry. This generator can aim toward some of those goals, but it does not enforce the full editorial rule set on your behalf.

Technical Details

Each non-empty line is split at the first colon. The text before that colon is treated as the answer field and the text after it becomes the clue. The answer field is uppercased and stripped down to letters A to Z only, so snow day becomes SNOWDAY and ice-cream becomes ICECREAM. If no letters survive, the line is ignored and reported as invalid. If the cleaned answer repeats an earlier cleaned answer, the later copy is removed as a duplicate.

The generator then works inside a square grid from 5 to 25 cells per side. The longest surviving answer is placed horizontally near the middle, and the remaining answers are tested only in horizontal and vertical directions. A legal placement must stay within the grid, agree with any letters already in place, avoid extra letters immediately before or after the answer, and avoid side contacts that would create stray fragments shorter than the chosen minimum word length.

The two search modes differ mainly in how hard they push for a better fit. Greedy takes the best placement it can see for each next answer and moves on. Backtracking ranks candidate placements, explores the stronger branches, and keeps improving the best grid it has seen until the time budget runs out. Candidate scoring rewards crossings, keeps some weight near the centre, and applies a penalty when the chosen symmetry mode would prefer matching occupied cells elsewhere in the square.

Formula Core

The main quality metrics compare filled cells with the full square and checked cells with filled cells. They are best used to compare runs made from the same answer bank, because a dense grid can still be weak if too few letters cross.

Generation, numbering, clue assembly, and file creation stay in the current browser session. Treat the page as local-first for ordinary classroom, event, and team puzzles, but avoid entering sensitive answer banks on a device or browser profile you do not trust.

Everyday Use & Decision Guide

Start by thinking about the word bank, not the styling controls. A custom crossword works best when the list mixes a few long anchor answers with shorter connector words that share common letters. If most entries are long, unusual, or built from rare letter clusters, the generator may still produce a grid, but the unused list or crossing rate will usually reveal the strain.

Choose grid size with room to spare on the first pass. A 15 x 15 square feels familiar, but it is not automatically the right size for every list. If one or two entries are close to the grid width, begin larger and shrink later. Tight grids can force clean entries out of the puzzle entirely, while oversized grids can leave you with a sparse layout that looks formal but solves awkwardly.

Use Greedy when you want a quick feasibility check. It is fast and good at telling you whether the bank is obviously workable. Use Backtracking when you care more about crossings, density, and overall fit. The Attempts (best-of) setting matters more than it first appears because each attempt reshuffles the entry order and the page keeps the strongest result automatically.

• Use a seed only after you find a layout you may want to reproduce. The same cleaned entries and settings recreate the same attempt family.
• Keep Min word length at 3 when you want a more conventional classroom or print puzzle. Lowering it helps fit but also relaxes the construction standard.
• Turn on rotational symmetry when appearance matters more than absolute fit. Mirror modes can still look tidy, but they are not the usual newspaper convention.
• Read Clues and Stats before exporting anything. A grid can look finished while still hiding leftovers, weak crossings, or clue text you never intended to publish.

Once the puzzle itself looks right, then move on to presentation. The design and export controls let you switch clue layout, show or hide the title and date, add a header note, thicken grid lines, boost contrast for photocopies, adjust blank-square colour and letter scale, and choose page size, orientation, and margins for printable output.

Step-by-Step Guide

1. Paste one entry per line in the form ANSWER:clue. If you want a phrase answer, enter it as plain text and let the page collapse spaces and punctuation automatically.
2. Run a first draft with a roomy grid and either Greedy or a short Backtracking budget. The first goal is to see whether the cleaned list is viable at all.
3. Read the warning block right away. It tells you which duplicates were removed and which lines were ignored because no usable letters remained.
4. Adjust Grid size, Min word length, Symmetry, Time budget, and Attempts (best-of) until the grid quality looks acceptable for your audience.
5. Review the Crossword Grid, then open Clues and Stats. Confirm that clue numbering looks clean, that blank clue fields are acceptable where you left them blank, and that no important entry is sitting in Unused entries.
6. If you want a reproducible version, keep the seed shown in the accepted run and avoid changing the cleaned entry list afterward.
7. Only after the puzzle content is settled should you export PDF, DOCX, CSV, or JSON. The exported files reflect the currently accepted run, not a separate reconstruction later.

Interpreting Results

Fill density is the easiest number to notice, but it is not the whole story. A crowded square can still be a weak crossword if many entries barely confirm one another. For this page, Crossing rate is usually the better fairness check because it tells you how much of the filled area actually interlocks.

Unused entries is the next number to trust. If the count is above zero, something in the bank or the constraints still does not fit the winning layout. That may mean the grid is too small, the symmetry choice is too restrictive, the word list lacks connector entries, or the list contains very long answers that do not share enough letters with the rest of the set.

Read Symmetry match carefully too. It compares the final occupied and empty pattern with the selected mirror rule. It does not certify a full editor-approved crossword, and it says nothing by itself about clue quality, theme placement, or whether every letter is checked in both directions.

Worked Examples

FAQ:

Glossary:

Checked letter

A cell that belongs to both an Across answer and a Down answer.

Fill density

The percentage of all grid cells that contain letters in the winning layout.

Crossing cell

A filled cell that has neighbouring letters in both the horizontal and vertical directions.

Seed

The text value used to reproduce the same attempt family when the cleaned list and settings do not change.

Unused entry

A cleaned answer that never appeared in the winning grid.

Symmetry match

The percentage showing how closely the occupied and empty pattern mirrors the selected symmetry mode.

References:

• Crossword Style Guide, The Michigan Daily.
• Crossword Grids, CrosswordGrids.com.