MithrilVote

How to run a cell

Five steps from turf to a send. Screenshots show the English admin and canvass screens.

Create a neighbourhood

Admin or leader Admin → Voters tab, Neighbourhoods

  1. Open the Voters tab.
  2. Under Neighbourhoods, enter a name for the cell.
  3. Paste postal codes or FSAs (for example M5V or M5V 2T6), comma or line separated.
  4. Click Save neighbourhood.

Watch out. Leaders can create and edit lists they made. Only an admin can delete a neighbourhood.

Neighbourhoods form with a name and postal codes filled in.
Name the neighbourhood and list the postal codes or FSAs it covers.

Add a canvasser

Admin or leader Admin → Team tab

  1. Open the Team tab.
  2. Enter a username and email. In production they get a link to set their password.
  3. Set Role to Canvasser — add voters on mobile.
  4. Check the campaigns they should see, then Save member.

Watch out. Leaders can add canvassers, not other leaders or admins. On a local test server, if you skip email they sign in with the same password as you.

Add team member form with a canvasser username, email, and campaign checked.
Create the canvasser on the Team tab and give them campaign access.

Assign the neighbourhood

Admin or leader Same Team form — Neighbourhoods checkboxes

  1. On Add team member, set Role to Canvasser so Neighbourhoods appears.
  2. Check the neighbourhoods they will walk.
  3. Save member. You can also edit an existing canvasser and change their turf later.

Watch out. Empty assignment means no turf: they cannot add or see households anywhere.

Team form showing neighbourhood checkboxes with a neighbourhood assigned to the canvasser.
Check the neighbourhoods this canvasser is allowed to work.

Canvass a household

Canvasser, leader, or admin Canvass page (/canvass)

  1. Open Canvass (from the header, or sign in as a canvasser).
  2. Type the street address. Lookup fills the postal code; change the address if you need a new postal.
  3. Enter name and phone. Set Vote (for / against / undecided), ask Yes or No to messages, and set this visit’s outcome.
  4. Add other voters at the same door if needed, then Save constituent.

Watch out. The postal must match an assigned neighbourhood. A door outside turf is rejected. Admins and non-local leaders are not limited this way.

Canvass form with address, postal code, name, phone, and vote filled in for a new household.
Add a new household from the door. The walk list below is existing turf, not this form.

Write a message and send it

Admin or leader Admin → Messages tab

  1. Open the Messages tab and pick the campaign.
  2. Click Add message. Write an SMS body with placeholders such as {{first_name}} and {{link}}. Email subject and body are optional.
  3. Save templates. HQ templates can only be changed by an admin; leaders copy one as their own version.
  4. Under Send, choose channel, message, audience, support lean, and neighbourhood. Click Send.

Watch out. Canvassers never send. A send needs a campaign, a template, and at least one voter who said yes to messages at the door. Households marked do not knock are skipped like opt-outs.

Messages editor with a new template labelled Door knock follow-up and an SMS body using placeholders.
Add a template. Placeholders are replaced per voter when you send.
Send panel with channel, message, support, and neighbourhood filters, and a Send button.
Filter who gets the wave, then Send. Use neighbourhoods to stay inside a cell.