itsthesheet User Guide

Everything you need to turn your Yellow Sheet and Green Sheet data into a mapped Atlas, contact batches, optimized field routes, and exports.

1 · Getting started

itsthesheet runs as a single app file in your web browser. After you sign in and download it from your dashboard, open the app and you'll see six tabs across the top:

TabWhat it's for
AtlasThe home map. Load your Yellow Sheet and Green Sheet files here and see records plotted with parcel outlines.
Table + ExportBrowse, filter, and select rows. Send selected rows to the Routing tool.
Email BuilderPull contacts out of your sheet and generate a batch of personalized email drafts.
RoutingTurn selected stops into optimized multi-day driving routes and export them.
Photo AtlasMatch GPS-tagged site photos to property parcels and export an attributed Excel with PID and civic address.
SettingsEnter your subscription token and check your account status.
Tip: the app remembers your loaded data and settings in your browser, so you can pick up where you left off.

2 · Account & download

  1. Go to itsthesheet.ca and click Start free trial. Enter your email, a password, and pick a plan. No credit card is required for the 30-day trial.
  2. Check your inbox for a “Verify your itsthesheet account” email and click Verify my email. This starts your 30-day trial and opens your dashboard.
  3. On the dashboard, click Download the app to get the app ZIP. Unzip it and open itsthesheet.html in your browser.
  4. Copy your app token from the dashboard, open the app's Settings tab, paste it into Subscription Token, and click Validate Token.
When your trial ends, add a card from the dashboard to keep going. Standard is $39.99/mo (1 seat); Enterprise is $99.99/mo (5 seats). The free trial includes a single seat, on Enterprise, the other 4 seats unlock once you subscribe.

3 · Import your spreadsheet & geocoding

Loading files

  1. On the Atlas tab, click the file picker and choose one or more .xls, .xlsx, or .csv files. You can select multiple files, or click again later to add more.
  2. Click Load Files. Your rows are parsed and column headers are auto-detected (for example “Site Address” becomes Project Address, “City” becomes Region).
  3. Records with coordinates plot immediately on the map. Use Refresh Map to re-plot, or Clear to start over.

How geocoding works

You don't run geocoding manually. Any row that doesn't already have latitude/longitude is geocoded automatically the moment you send rows to the Routing tool. Rows that already have coordinates are used as-is, and results are cached so repeat runs are fast.

For best matches, include a street address and a town/city in your sheet. A town name alone still works but is less precise.

4 · Routing, optimized multi-day routes

Send stops to Routing

  1. Go to Table + Export, filter as needed, and tick the rows you want (or use Select Visible).
  2. Click Send Selected To Routing Tool. Any rows missing coordinates are geocoded automatically, then handed to the Routing tab.
  3. Open the Routing tab to set up the trip.

Route Settings

SettingDefaultWhat it does
Service minutes per stop15Time spent at each location; factored into the daily limit.
Max hours per day8The longest a single day's route can run (drive + service).
Max stops per day40Upper limit on how many stops fit in one day.
Estimated ferry wait time (min)0Per-crossing terminal wait added on ferry legs (sailing time is already counted).
Single-day out-and-back (no overnights)offWhen on, every day starts & ends at one base address; hides Trip END and overnight fields.
Max days (upper bound)5The most days the planner may use.
Trip START address, Where the trip begins (street address or just a town).
Trip END address, Where the trip ends. Hidden in out-and-back mode.
Allowed overnight locations, One per line; towns/addresses the planner may overnight in.
Every setting above is fully user-adjustable. The values in the Default column are just convenient starting points shown when you open the Routing tab, none of them are hard-coded. Change any parameter to match your crew, vehicle, and trip before you run.
Limits per route: max 250 stops · max 5 days. For bigger jobs, split into batches.

Run it

  1. Click ▶ Run routing. The progress stepper moves through Data validation → Matrix calculation → Route optimization → Map generation.
  2. When it finishes, review the results panel: 🗺️ Trip map (interactive map of all days) and 📋 Summary (itinerary, distance, time). Use ✕ Back to planning to adjust and re-run.
  3. Click ⬇ Download route ZIP to save the field-ready package.

What's in the route ZIP

  • Map.html, interactive map of the whole trip, color-coded by day.
  • Route_Summary.html, styled per-day itinerary with times and stop counts.
  • Servicing_List_Routed.xlsx, your stops in routed order.
  • GoogleEarth/, KMZ files of routes and property outlines for Google Earth.
  • Navigator/Day1.html …, a simple turn-by-turn page per day.
  • data/, GeoJSON + route JSON for advanced use.

5 · Email Builder

The Email Builder pulls every unique email and cell number out of your loaded sheet, then generates a batch of personalized email drafts you can send.

  1. Open the Email Builder tab. Choose a scope, All uploaded rows or Selected map/table rows, and narrow with the search box and the Contact Type (All / Emails / Cells), Contact Header, and sort options.
  2. Click Select Filtered Emails to select everyone matching your filters (or Clear Selection to reset).
  3. Fill in the Batch Email Template:
    • Batch Name, names the output ZIP (e.g. “Batch 1”).
    • Subject, the email subject line.
    • Message Body, your message. Use merge tokens that fill in per contact.
    • Signature, your sign-off.
  4. Click Create Email Batch, review the Draft Preview, then Download Batch .zip.

Merge tokens

TokenFills in
{{contact}}The recipient's name/email.
{{type}}Contact type, Email or Cell.
{{headers}}The source column the contact came from (e.g. CONTRACTOR).
{{count}}How many records reference this contact.
{{email}} / {{cell}}The email address / cell number, when available.

The download is a ZIP of individual .eml draft files, one per contact. Open any of them in your email client to review and send.

6 · Video walkthroughs

Short screencasts for each workflow. (Coming soon, links will appear here.)

Getting started & loading your sheet
Optimizing a multi-day route
Building an email batch
Exports & using them in the field

7 · Request a feature

Got an idea that would make itsthesheet better for your work? Tell us, we read every request and it directly shapes what we build next.

8 · Troubleshooting

My records didn't plot on the map.
Make sure your sheet has an address column, then click Refresh Map. Rows without coordinates plot once they're geocoded (when you send them to Routing).
“Run routing” is greyed out.
You need at least one geocoded stop and a Trip START address (plus a Trip END unless you're in out-and-back mode).
My route is too long / won't fit.
Raise Max days or Max hours per day, lower service minutes, or split into batches. Remember the limits: 250 stops and 5 days per route.
Ferry trips look too short.
Set Estimated ferry wait time to add terminal queue time on crossings.
The app says my subscription is inactive.
Open Settings, re-paste your token from the dashboard, and click Validate Token. If your trial ended, add a card on the dashboard.
Still stuck?
Email hello@itsthesheet.ca and we'll help.

9 · Changelog

v0.5.0 Jobs as My work binder (stages, notes, photos/voice, route marks), field-day phone export/import with storage safety + multi-part packs, job ZIP export for clients, Atlas Show Jobs on map overlay, DriveBC/weather on routes, Upload field day from Jobs and Settings.
v0.3.1 Atlas map, Table + Export, Email Builder, Routing (up to 250 stops / 5 days), Photo Atlas, and field-ready exports.

Need a hand? hello@itsthesheet.ca