Your Score
{{ score }} / {{ totalQuestions }}
{{ correctPercent }} % Correct {{ incorrectPercent }} % Wrong {{ activeSetLabel }}

Match each flag to its {{ promptNoun }}. Choose how many questions you want and optionally set a seed to make a shareable quiz.

Pool size: {{ poolSize }}
{{ progressPercent }} %
{{ questionHeading }}
# Flag Your Answer Correct Copy
{{ i + 1 }} {{ row.yourAnswer }} {{ row.correctAnswer }}

                
:

Introduction:

Subdivision flags are visual symbols used by states, provinces, regions, counties, and similar areas to represent identity and jurisdiction. A state and province flags quiz helps you learn those designs faster by turning recognition into a short decision you can practice repeatedly. You see a flag, choose the matching place name, and the score shows how often that recognition is correct.

Because many subdivision flags reuse colors and coats of arms, it is easy to confuse places that sit far apart. Short practice sessions build faster recall, and they make maps, news, and travel conversations easier to follow.

Pick a country or region set, decide how many questions you want, and optionally enter a seed to repeat the same draw later. Each question offers a small set of possible names, and you get immediate feedback after you answer. If you are preparing for a class quiz, reuse the seed to replay the same questions until the ones you missed become familiar.

A high score means you recognized patterns today, not that you know every detail about those places. Treat the result as a study guide, especially when two flags share the same layout and differ only by a small emblem. If you share a seed with others, avoid personal identifiers and use something you would be comfortable repeating in public.

For the clearest improvement, compare results across the same set and question count, then retake and watch your incorrect list shrink.

Technical Details:

This quiz measures recognition of subdivision flags by asking you to link a flag image to one subdivision name. Its core signals are simple counts, how many you answered correctly, how many were incorrect, and the percentage correct.

The score is the number of correct answers out of N questions, and the percentage values are rounded to whole numbers for quick reading. To compare practice sessions fairly, keep the same set and question count, and reuse the same seed when you want the exact same draw.

Because the questions come from a finite pool, small quizzes can swing by chance, especially when you are guessing between similar designs. Use larger question counts when you want a steadier percentage, and treat small runs as warm ups rather than a final measure.

A seed drives a pseudo random number generator (PRNG) that shuffles the pool of regions and the answer options, so the same seed reproduces the same quiz.

Scoring math

score = i=1 N ci ci = 1  if answer  i  is correct, else  0
correctPercent = round ( scoreN × 100 ) incorrectPercent = 100correctPercent progressPercent = round ( answeredCountN × 100 )
Symbols used in quiz scoring
Symbol Meaning Unit/Datatype Source
N Total number of questions in the quiz run integer count derived
score Number of questions answered correctly integer count derived
ci Correctness indicator for question i 0 or 1 derived
correctPercent Correct answers as a rounded percentage of N percent (integer) derived
incorrectPercent Incorrect answers as a rounded percentage of N percent (integer) derived
answeredCount How many questions have been answered so far integer count derived
progressPercent Answered questions as a rounded percentage of N percent (integer) derived

Quiz generation and scoring pipeline

  1. Load the chosen set and build the pool of subdivision names and codes.
  2. Clamp the requested question count to an allowed value for that pool.
  3. Initialize the PRNG from the seed string, or from a time based fallback.
  4. Shuffle the pool, then take the first N entries as questions.
  5. For each question, sample up to three distinct distractor names.
  6. Shuffle the answer options and record the index of the correct option.
  7. When you answer, store the chosen index and increment score on a match.
  8. Compute whole percent summaries with Math.round at the end.

Parameters and data model

Key parameters that shape a quiz run
Parameter Meaning Unit/Datatype Typical Range Sensitivity Notes
Set Which country or region collection the flags come from string id one of built in sets High Also changes the pool size and allowed question counts.
Pool size How many subdivisions are available in the selected set integer count set dependent Medium The quiz draws without replacement from this pool.
Question count How many questions are included in a run integer count set dependent High Values are clamped to an allowed list for the chosen set.
Seed Text used to reproduce the same shuffle and options string any length High Case and spacing matter because the seed is hashed as typed.

Units, precision, and rounding

  • Percent values shown during play and in the score summary are whole numbers from Math.round.
  • Whole percent rounding follows standard half up behavior for non negative values.
  • The answer chart CSV includes Correct (%) formatted to two decimal places.
  • All counts are integers derived from array lengths and chosen indices.

Validation and bounds

Input validation and automatic correction rules
Field Type Min Max Step/Pattern Error Text Placeholder
Quiz set enum Must match a built in set id None, falls back to a default set
Number of questions enum 1 pool size One of the allowed counts for the chosen set None, clamps to the nearest allowed value
Random seed text Any string, trimmed for leading and trailing whitespace None e.g., usa-quiz-42

Outputs and formats

Result outputs produced after finishing a quiz
Output Contents Encoding/Precision Rounding
Results table as CSV Columns Q, Your Answer, Correct, Correct? Plain text Not applicable
Quiz summary as JSON Set id and label, seed, question count, score, percent, and per question rows Pretty printed with indentation Percent is whole number
Results report as DOCX Title, a short run summary, and a table of answers and correctness Document file Percent shown as whole number
Answer breakdown chart images Pie chart with correct and incorrect counts Image file generated from a canvas snapshot Chart labels show whole percent
Answer breakdown chart CSV Metrics for correct, incorrect, total, and correct percentage Plain text, percent formatted to two decimals Two decimals in chart CSV

Networking and storage

  • Flag images are requested directly from external image hosts, depending on the chosen set.
  • For many sets, Wikimedia Commons thumbnails are requested at a width of 320 px.
  • Some sets request images from FlagCDN using both PNG and SVG candidates.
  • When an image fails to load, the app falls back to an embedded SVG placeholder.
  • Quiz answers and results are kept in page memory during the session and can be copied or downloaded on demand.

Performance notes

The quiz generator shuffles the pool once and then builds answer options per question, so runtime grows with pool size and question count. Chart rendering and image downloads happen only after you finish.

Security considerations

  • Sharing a seed can reveal patterns about your practice set, so avoid personal or sensitive text.
  • External image requests may be visible to your network, even though your answers are not uploaded.
  • The JSON preview is rendered as highlighted markup, so it relies on correct escaping by the formatter.
  • Downloaded files are generated from your current run, so double check the set label before sharing.

Assumptions and limitations

  • The quiz measures recognition, not deep knowledge about a place.
  • Different sets have different pool sizes, so scores are not directly comparable across sets.
  • Heads-up If a network blocks image hosts, you may see placeholders instead of flags.
  • Percentages on screen are rounded, so small changes can be hidden in short quizzes.
  • A repeated seed reproduces the same draw only when set and question count also match.
  • The distractor sampling relies on repeated random picks, so option ordering is not designed for cryptographic fairness.
  • Correct looking options do not guarantee the flag image loaded is the most current design.
  • Copy and download features depend on browser permissions and may be restricted in locked down environments.

Edge cases and error sources

  • Empty or invalid set ids fall back to a default set during normalization.
  • Question counts outside the allowed list are clamped to the nearest allowed value.
  • Names with accents can display differently across fonts, which can affect quick scanning.
  • Image hosts can rate limit or block requests, leading to repeated load errors.
  • Cached images can mask an outage until the cache expires, then failures appear suddenly.
  • Clipboard writes can fail when a page is not focused or permissions are denied.
  • Download prompts can be blocked by popup and download controls.
  • Chart creation can fail if the charting layer does not load, leaving the chart region blank.
  • Very small pools leave fewer plausible distractors, which can make some questions too easy.
  • Time based seeds are intentionally non repeatable, which can surprise users expecting a replay.
  • Rapid resizing during chart rendering can cause temporary layout glitches until a redraw.
  • Stale cached scripts can cause mismatches between UI and logic after updates.

Data sources and standards context

Flag images in this package are sourced from Wikimedia Commons and FlagCDN, depending on the selected set. Results are represented using common interchange formats such as CSV and JSON, and the DOCX report follows the Office document family.

Privacy and compliance

Your answers are processed locally for the session and the package does not include code that uploads your results, but it does request flag images from external hosts. Question selection uses pseudo random shuffling and has no monetary value.

Step by Step Guide:

Subdivision flag practice works best when you repeat the same conditions, then focus on the names you missed most.

  1. Choose a Quiz set that matches what you want to learn.
  2. Select a Number of questions that fits your time and attention.
  3. Optional, enter a Random seed when you want a repeatable run.
  4. Start the quiz and answer each flag by picking the best matching name.
  5. When finished, review which questions were correct and which were missed.
  6. Retake with the same seed to check improvement, or generate a new seed for fresh practice.
  • Use the same set and question count when you want to compare scores across days.
  • If you are guessing often, increase question count to smooth out chance swings.
  • Warning Avoid personal information in the seed if you plan to share it.

Pro tip: keep a small notebook of the flags you miss, then retake the same seed until that list is empty.

Features:

  • Multiple built in sets covering states, provinces, regions, and other subdivisions.
  • Repeatable runs using a seed for the same question draw and option order.
  • Immediate correctness feedback, plus a final score with correct and wrong percentages.
  • Answer breakdown chart and downloadable chart images for quick sharing.
  • Results table you can copy, download, or package as a report document.

FAQ:

Is my data stored?

Your answers and results live in memory during the session, and the package does not include code that uploads your results. Flag images are fetched from external hosts when they load. If you copy or download results, you control where those files go.

How accurate is the score?

The score is a direct count of correct selections, and the displayed percentages are rounded to whole numbers. For small quizzes, one question can change the percent noticeably, so use more questions when you want a steadier read.

What does the seed do?

The seed drives the shuffle used to pick questions and order options. If you keep the same set, question count, and seed, you will get the same draw again, which is useful for repeat practice and comparisons.

Can I use it offline?

The quiz logic can run without a connection, but the real flag images are loaded from external hosts. If images cannot be fetched, the quiz falls back to an embedded placeholder image, and the chart may not render if its script is unavailable.

How do I share a quiz?

Share the same set choice, question count, and seed text. Anyone using those same inputs should see the same questions and option ordering, making it easier to compare scores.

Borderline result meaning

A borderline result is a score that feels uncertain because it is based on few questions or many close looking flags. Increase the question count or repeat the same seed to see whether the percentage stabilizes.

What formats can I save?

After finishing, you can copy or download a CSV results table, download a JSON summary, generate a DOCX report, and save the answer chart as PNG, WebP, JPEG, or CSV.

Is there a cost?

The provided package does not include purchase flows, sign in screens, or license gates. Any pricing or licensing terms depend on where the page is published and how it is distributed.

Troubleshooting:

  • Flags show as blanks: check your connection and allow requests to the image hosts.
  • Flags show as code letters: the image failed and the placeholder fallback was used.
  • Copy does nothing: focus the page, then try again, and confirm clipboard permission.
  • Downloads are blocked: allow file downloads for this site, then retry the action.
  • My quiz changed: confirm set, question count, and seed match exactly, including case.
  • Chart area is empty: reload the page, then open the chart tab again after finishing.

Advanced Tips:

  • Tip Use a stable seed for daily drills so improvements are comparable.
  • Tip Start with small sets, then move to larger pools once your accuracy stays high.
  • Tip Keep question count constant when comparing two practice sessions.
  • Tip Treat close misses as a prompt to learn one distinguishing feature per flag.
  • Tip Export a results report after a long run to track which names repeat as errors.
  • Tip When images fail, use the placeholder code letters to keep practicing the names.

Glossary:

Subdivision
A state, province, region, county, or similar administrative area.
Pool size
How many subdivisions are available in the selected set.
Seed
Text that recreates the same shuffle and question draw.
PRNG
Pseudo random number generator used for shuffling.
Distractor
A wrong option included to make a question multiple choice.
Placeholder
Embedded SVG shown when a flag image fails to load.