How CivicsWise is made
This page describes the process behind every page of CivicsWise: which documents the questions and explanations come from, how an explanation is put together, which automated tests are run before a change goes live, and what happens when something turns out to be wrong.
In numbers: 190 questions have their own page with a written explanation, and those explanations carry 941 citations to 34 documents. Each number on this page is counted from the site's data when the site is built, so it stays accurate as explanations change.
Where each piece of information comes from
The questions and the accepted answers
The wording of every question and every accepted answer is copied from the official USCIS lists: the PDF 128 Civics Questions and Answers (2025 version) for the current test, and the list of 100 questions for the 2008 test. A script downloads each PDF and extracts the text, so no question is typed by hand. The lists are works of the federal government and in the public domain, which is why they appear word for word.
The rules of the test
How many questions the officer asks, how many you need right and when the officer stops come from the USCIS Policy Manual and the 2025 civics test page. On the site those rules live in one configuration file, each with the source it came from, and every page reads them from there. That is why the 20 questions, the 12 correct answers and the stop at 9 incorrect answers say the same thing everywhere: they are written in one place.
The explanations
Explanations are written from primary documents only. The main one is the official study guide, One Nation, One People: The USCIS 2025 Civics Test Study Guide. For facts the 2025 guide does not develop, and for the 2008 test, the source is the older USCIS booklet Learn About the United States: Quick Civics Lessons for the Naturalization Test (2008 version), M-638 (rev. 08/21). Questions about the founding texts cite the transcriptions published by the National Archives and the Library of Congress. No blog, encyclopedia or other study site is used as a source.
These are all the documents the explanations cite, with how many citations point to each:
Answers that change
A few questions ask who holds an office now: 4 in the current list (questions 30, 38, 39 and 57). The official list gives no name for those answers and points to the USCIS page Check for Test Updates. The names on CivicsWise come from that page and are kept in a single data file. They never appear inside an explanation, so an election or an appointment means one edit, not a search through dozens of pages. The guide to answers that change explains how this works.
Answers that depend on your state
Four questions in the current list have no single answer, because they ask about your senators, your representative, your governor and your state capital. For 56 states, territories and the District of Columbia, senators come from the U.S. Senate, representatives from the Clerk of the House, and governors from USA.gov. A capital is published only where the state's own constitution or statutes name the city: 43 of the 55 jurisdictions that need one. For the rest the site shows no capital rather than infer one from where the governor's office or the legislature happens to sit.
How an explanation is written
An explanation starts from the official answer and works backward to the idea behind it. It says what the answer means, why it is the answer and, where it helps, what people tend to confuse it with. Most end with one short line meant to help the answer stick.
The explanation is written with its documents open, in plain words of our own. Every hard fact in it, whether a date, a number, a name or a rule, has to be traceable to one of its citations. A citation names the document, the section and, for a PDF, the page number printed on the sheet, and it stores the passage it relies on. An explanation carries between one and five citations. On each question page they are listed under Sources, and a citation to a PDF opens the document at the cited page.
One rule covers answers in particular. When an explanation lists more than one of the answers USCIS accepts, or says how many there are, it has to cite the official list itself, not a study guide. Study guides explain a topic in their own words, and their wording does not always match what the officer will accept.
The practice test also needs wrong options for its multiple-choice mode. Each question with a fixed answer, apart from the officeholder questions described below, gets three, written to be plausible but never misleading; 540 in all. They are there to make you choose, and they are tested against the official answers like everything else. Where a question asks you to name two or more things (12 questions), the practice test says so, because a multiple-choice option shows only one answer and the officer will ask for all of them.
What is tested before anything is published
The site has a set of automated tests for the questions, the explanations and the state data. They are run by hand before a change is published, and a change that fails one is fixed before it goes out. In plain language, they test that:
- Every explanation has citations. No question page is built without an explanation, and no explanation without at least one citation to a document on the closed list above. Of the 941 citations, 708 point to a specific printed page.
- Every citation is found in its source. A script downloads each document, goes to the page the citation names and looks for the stored passage, comparing letters and numbers only so that quotation marks and line breaks do not matter. If the passage is not on that page, the test fails and the citation is fixed.
- No wrong option matches an accepted answer. Each of the 540 wrong options is compared with every accepted answer to its question, after removing parentheses, leading articles and punctuation. A match is an error that has to be fixed first.
- Questions about current officeholders have no wrong options. The 4 in the current list and the 6 in the 2008 list are left out of the multiple-choice practice. Writing wrong options for them would mean listing real people as incorrect answers, and those names age badly. Their explanations are also tested to make sure they never contain an officeholder's name.
- State data has an expiry date. Senators, representatives and governors change with elections. Each state's data expires on the day of the next federal election or 180 days after it was collected, whichever comes first. Every build of the site checks that date, and an expired state is left out until its data is collected again. The next federal election is November 7, 2028. Each published capital is also tested against the official text that names it.
- The explanation is in its own words. An explanation that reproduces one of its cited passages of 80 characters or more word for word fails the test and is rewritten.
These tests have a limit. Finding the stored passage on the cited page shows that the source says those words. It does not prove that the explanation reads them correctly. That is the reason the citations are public: you can open the page and judge for yourself.
How a mistake is corrected
A correction is made in the data, not in a single page, so every page that shows the same fact changes with it. The tests are run again before the fix is published.
When a correction touches an answer, the fix starts from the official list or the Policy Manual, never from memory or from another website. If the fact cannot be traced to a document on the list above, the sentence that states it is removed rather than left without a citation.
How to report a mistake
If you find an answer that looks wrong, an explanation that confused you, or a state answer that is out of date after an election, write to us through the contact page. The most useful report says which question it is (the number, and whether it is the 128-question list or the 100-question one), what the page says, and what you think it should say. If you have the official document open, the page number helps.
For anything about your own case, such as your interview date or your application, contact USCIS directly. More about the site is on the about page, and you can browse every question with its sources from the question index or the 2008 test.