TRC Map View

TRC includes a map view that shows you the voters as pins on a map. This is a standard view similar to what you’d see in any canvassing app. Since it runs directly in the browser, there’s no additional installation step needed.

The map view is exactly the same underlying information as in the List View, so you’re encouraged to use whichever view makes you most productive.  You can make changes in the map view, and then immediately switch to the List View and see them.

A common pattern is to use Geofencing to carve up a large region into smaller neighborhoods, and then you can use the map view to canvass those neighborhoods.

Using the map view

The pins are color coded by party ID. Hollow pins are doors that have already been visited. You can go back and edit answers on visited doors.


You can touch a pin to see the voters at that household:


If nobody is home, you can mark “Result Of Contact” for the door and move on. Else, you can select an individual to see their information and record the canvassing results.

Be sure to

  1. fill out the Party ID,
  2. fill out whether they’re a supporter, and
  3. result of contact.
  4. hit the “Save” button


Getting to the map view

You can get to the map view by touching the “View Map” buttons on the standard walking list.

Offline usage

The map view leverages HTML5 local storage support to provide an offline experience even though it runs in a browser.

This means that you can load the map view while you have an internet connection, and then canvass offline, and then upload the results when you’re done. However, it’s highly encouraged to canvass with a cel connection so that your results are immediately uploaded. Even if you temporarily lose connectivity, your results will be uploaded when you regain a connection.

To verify your results are all uploaded, on the main page, touch “Local Storage” in the upper right corner. That will take you to a page like this:

Hit the refresh button to pull the current status. If you have outstanding changes and running offline, you’ll  see something like this:


Once you’re back online, hit the “Refresh” button again once online and verify the “Number of Changes not yet uploaded” is 0.




How to filter lists

TRC lets you filter your lists.  The filter will create  a new share code that lets you then share your filtered view with others  or use your filtered view with other parts of TRC like printing and maps.

You can access filtering via the standard list view.  Click the filter icon in the top-left view:


Select the filter accordingly. Be sure to include a name for the filter (highlighted in yellow) and then click “apply”

Common things to filter on are:

  • History –   this is how likely somebody is to actually vote.
  • Party Id  – this is the party affiliation.


It’s important to give the filter a name.

That will take you back to the list and you’ll see your new filter.


Click on “walking list” next to that filter, and you’re now viewing just within the filter.

You can click “share this” to share just this filter with another volunteer.

You can click “view entire walking list” to get back to the full list and possible create new filters.


Technical notes

Filtering creates a new “child” sheet that applies a filter-expression to extract a subset of the rows from the original (“parent”) sheet. The filter creates a a view that shares the same sandbox as the original sheet, so all changes in the child are instantly visible in the parent. However, the child sheet still maintains its own history tracking and audit logs.




TRC ListView

TRC’s default view is the “ListView”, which looks like a digital clipboard. Names are organized by street.   There are also other views, such as the common map view.

See  for a youtube demo.

The view looks like this:


In the ListView, each row is a voter. Voters are grouped by address so that you can easily identify all voters at a single household when you’re at the door.  You can collapse voters by streets for easy managing.  The grouping is zebra striped (yellow /  white + grey) for easy-reading. The stripe color is purely ascetic.

When you edit cells, they start off red, and then turn green when they’re uploaded to the server.


This provides immediate feedback on upload. Cells are colored red when you edit and green when their result is uploaded to the cloud, so you get immediate piece of mind that your changes are safely saved.

TRC supports collaborative editing: when multiple canvassers are walking the same precinct, other canvasser updates show up on your sheet in realtime.


Standard columns:

The default view in TRC includes some standard columns:

  • Voter address, name, age, gender – this is commonly from public Secretary of State Voter Database (VRDB)
  • History – this is a percentage of likeliness to vote in the upcoming election. This is similar to the “how many of the last  4 elections did they vote in”.  It’s computed via a predictive model and measurably more reliable than just a “4 score”.
  • Party – this is a party identification.
  • Supporter – Does the voter support your campaign? This likely correlates with party, but is very important in tracking cross-over voters and non-partisan races.
  • Comments – – this lets a canvasser provide free-form notes.

See Pinned vs. Floating values  for more details on where the data comes from.  

Targeted Voters

TRC will bold the “targeted” voters to help canvassers prioritize who to visit. For example, a precinct may have 500 people but you only have time to talk to 50 voters. The “targeting” helps prioritize which ones to talk to. TRC uses a default targeting algorithm, or you can supply your own targets, or you can coordinate with Voter-Science to use analytics to get a special target list for your campaign.

We continue to show all the voters because if you happen to talk to a non-targeted voter, we want to make it easy to record that information. (Knowing who the opponents are makes it easier to guess who our guys are).


Washington State is vote-by-mail. That means that people are casting their votes 3 weeks before the election. During these ballot chase periods, names will also be crossed off as people have voted.   Voter-Science collects the matchbacks from the county auditors.  See Prepping for the ‘16 General for more details.

Sharing with TRC

You first receive access to TRC via a “canvass code” or a secret URL. Normally, this arrives in an email to you.

The code is an 8-12 digit secret code that uniquely identifies you. It’s effectively a password. You can enter this in the starting webpage or on the phone apps.

For convenience, the code can also be directly embedded in a URL like this so that a single click takes you straight to your sheet:

Don’t share this url with anybody!


Facebook login

For larger areas, such as an entire Legislative District, TRC may also prompt you for a Facebook login. We use Facebook because:

  1. It’s convenient. Nobody wants to remember yet another password.
  2. Facebook is a secure system and has advanced security features like two-factor-authentication.
  3. We want the extra security when handling larger amounts of data.

For smaller areas, such as individual precincts with just a few hundred voters, you don’t need a Facebook login.

If you’re logged in with Facebook, then TRC can also remember the list of codes you’ve visited and will display them at the homepage, at:

Sharing sections of your sheet with new volunteers

Suppose you’re granted a code for an entire city with 10,000 voters.

You can share out individual precincts with volunteers. On the main screen, you’ll see a list of the precincts and a “share this” button:



When you hit the “Share this…” button, you can enter an email address and short personal message.



And then the volunteer will get an email with their own canvas code (just for their precinct) and their own url link. They can receive the email on their smartphone and open the app directly from there and be ready to go.

This code will be different than your original code. Unique codes let the system identify different users.


Who can I share with?

You could share a single precinct with multiple people and each would get their own unique code. This lets you identify each individual.

TRC does not charge per-user, so you are encouraged to share with as many people as you need.

Revoking codes

You can also revoke codes that you’ve shared out. For example, you may do this if you typed in the wrong email address.

Geek stuff

What a code is really doing is giving you access to a sandbox. You can share  a single sandbox with multiple people and use the per-user code to track which user is accessing the sandbox. By default, a legislative district split into precincts means that each precinct is a child sandbox.


“Blame” is a free reporting plugin for TRC to help you analyze canvassing results.  Blame provides easy pivots (“business intelligence”) on the data collected by your canvassers. This helps you answer key questions that lead to action:

  1. How many doors did your team hit per day?
  2. Who exactly did you contact and what was the result? Pull the details into excel for further analysis.
  3. How many supporters did you identify?
  4. What was the specific result for each canvasser?  Which volunteers should be rewarded and which need more coaching?
  5. Are there suspicious trends in the data?

(The name Blame comes from similar tools in the software industry that developers use to find who edited a file and introduced a bug)

Opening Blame

You can launch Blame from the plugin menu:


Or by appending &plugin=Blame2 at the end of your login link.


TRC tracks each individual edit supplied by a user. An edit includes not only the actual change to the sheet (“voter #5472 is a supporter”), but also timestamps, geo location, user id, and even which plugin made the edit.

Basic Views

There’s a timeline chart showing you edits per day. You can use the slider bar at the bottom to zoom in on a range, such as a super Saturday.


Blame provides pivots. For example, you can see number of supporters identified and by whom.



Blame also presents a “grid view” of all the individual edits. This provides a convenient way to see just the values that have changed. You can view and download all the edits in a single spreadsheet:


If a single record has multiple changes, blame will flag it and let you drill into more detail and see the exact history.



This can be useful to identify records changed by multiple people.