Districtr User Guide

Getting Started

  1. On the Districtr home page, click “Draw a new plan” in the top right corner.
  2. You will be redirected to an interactive map of the United States. Click the state for which you want to create a districting plan.
  3. Once you have selected a state, choose a module to complete from the displayed list of options.
  4. You will now be redirected to your requested Districtr module.
move tool

Main Tools

Move Tool

To move across the state map, click the hand icon in the toolbar in the top right corner of the page. This allows you to click and drag to pan across the map.

move tool

Zoom Tool

Click the plus (+) and minus (-) buttons on the top left corner of the page to zoom in and out of the map.

zoom tool

Paint Tool

  1. Click the paintbrush icon in the toolbar in the top right corner of the page.
  2. Each color corresponds to a different district.
  3. Click and drag across the map to add units to that district.
    • To change the size of the brush to capture more or fewer units per stroke, slide the brush size option.
    move tool
  4. Once you’re done drawing districts and want to inspect further without altering them, select the “Lock already-drawn districts” box in the tool’s menu.
move tool

Eraser Tool

  1. Click the eraser icon in the toolbar in the top right corner of the page.
  2. Click and drag across the map to remove localities from that district.
    • To change the size of the brush to remove more or fewer units with each stroke, slide the eraser size option.
move tool

Inspect Tool

  1. Click the magnifying glass icon in the toolbar.
  2. Click the Tooltip Data dropdown to select which type of information you wish to inspect.
  3. Hover over a portion of the map to see the corresponding statistics for that area.
  4. Slide the spotlight size option in the tool’s menu to change the size of the spotlight to inspect more or fewer units.
move tool



The population tab allows you to see the population of each district you have created. Use it in conjunction with the paint tool to show the population balances of each of your districts

move tool

Check the highlight unassigned units box to see which districts you still need to color

move tool

Data Layers

The data layers tab allows you to visualize demographic, voting age population, and partisanship data for each state

move tool
Voting Age Population
move tool
Partisan Lean
move tool

Each variable can be visualized as either shaded regions in a choropleth map or different sized circles proportional to the amount of a variable in each district

move tool


The evaluation tab allows you to see the racial, voting age population, and partisan balance of the district plan you’re making

move tool


About this Module

This tab provides additional information on the units used in the module, relevant state laws, and sources for shapefiles and data.

New Plan

This tab takes you back to the main Districtr menu. It allows you to select a different module and begin working on a new districting plan.

Export this plan

Export your district plan as a JSON.

What is a JSON?
JSON is short for JavaScript Object Notation. It stores information in an organized manner that humans can access in a readable and logical manner.
Why would I export it?
By exporting a JSON you can save your district plan and reload it into Districtr.

Export as assignment CSV

Export your district plan as a CSV.

What is a CSV?
CSV is short for comma-separated values. It is a delimited text file that separates all values by a comma and only includes numbers and text.
Why would I export it?
By exporting a CSV, it is easy to read the information into programming languages like Python.
move tool