Trails
Trail Planner — record, draw, or find a sustainable line
Plan trail before you build it: record a line in the field, draw it on the dashboard, or let the route finder search the hillside for you. Covers activity profiles, the half rule, the terrain analysis, build-cost estimates, editing and comparing options, walking a line more than once, public proposal pages, and exporting a finished plan into your live network.
The Trail Planner is where a trail exists before it exists. You get a line onto the map — walked, drawn, or proposed by the route finder — and TrailsIQ measures it against the terrain underneath, prices it, and gives you something to show a landowner or a board. Nothing in the planner touches your live trail network until you deliberately export it.
Three ways to start a line
Record it in the field. Open the Field App, start a Plan / Record session, and walk or ride the line. The native shell uses a dedicated GPS plugin rather than the browser's, so the trace survives a locked screen. This is the honest option — you find out about the wet spot and the rock band while you are standing on them.
Draw it on the dashboard. Trail Planner → Draw. Click along the line on the map. Every click is a vertex; the line is analyzed against the terrain as you go, so you can see a stretch turn red before you commit to it.
Ask for it. Trail Planner → Suggest. Drop a start and an end, pick what the trail is for, and the route finder searches the hillside for a sustainable line between them. See below.
All three produce the same thing — a planner recording — and everything after this point applies equally to whichever you used.
Suggest — let TrailsIQ find the line
Suggest runs a route search across the elevation grid, weighing grade, cross slope, turn radius and fall-line alignment against each other, and returns the best line it can find between your two points.
Line type sets what you are building and colors it on the map: Alternate, Reroute, Spur, or Connector.
Preset sets the search's temperament:
| Preset | What it optimises for |
|---|---|
| Balanced | The default sustainable-line search |
| Flow | Sweeping curves, moderate grade |
| Tech | Steeper grades OK, sharper turns allowed |
| Chill climb | Strict 5% cap, tight traverse, avoids wetlands |
| Aggressive descent | Steep grades, straighter lines acceptable |
Under the presets, every individual constraint is exposed as a slider — grade ceiling, turn radius, and the rest — so a preset is a starting point rather than a box you are stuck in.
When the finder cannot meet your constraints, it does not fail silently or quietly bend them. It returns the best line it found and tells you plainly which constraint it had to relax to get there. That banner is the useful part of the answer: it is telling you the terrain does not permit what you asked for, which is worth knowing before you flag anything.
Those banners are checked against the line you got. Preset grade cap relaxed names the grade the suggested line actually reaches, and only appears when the line really does exceed your cap. It used to be able to appear over a line at a tenth of a percent — the search abandons a pass when it runs out of time, which looked from the inside exactly like a pass that had proved the terrain impossible, and got reported as one. A claim about the hillside is now backed by a measurement of the line.
Search cut short is the separate notice for that case, and it means what it says: the search ran out of time before it finished testing your constraints, so the line came from a relaxed pass and the constraints were never disproved. The figures on the line are measured from the line and stand. Endpoints closer together give the search room to finish.
Activity profiles
Picking an activity applies an envelope of what that use can physically carry. It sets the turn radius the line must respect and the corridor width the cost model prices.
| Activity | Min turn radius | Grade ceiling | Default width |
|---|---|---|---|
| Hiking | 2.5 m | 15% | 2 ft |
| Trail running | 4 m | 12% | 2 ft |
| Mountain biking | 6 m | 15% | 3 ft |
| E-MTB | 7 m | 18% | 3.5 ft |
| Adaptive / accessible | 10 m | 8% | 5 ft |
| Equestrian | 8 m | 12% | 4 ft |
| XC ski (groomed) | 15 m | 10% | 10 ft |
| Snowmobile | 20 m | 15% | 10 ft |
| ATV / OHV | 12 m | 18% | 6 ft |
These are platform baselines drawn from the usual references — IMBA difficulty guidance, USFS trail class matrices, groomed-surface norms — and every one of them is overridable on the constraint sliders. Choosing Any activity removes the envelope entirely.
The turn radius is the number that changes the shape of the answer most. A snowmobile corridor and a hiking trail across the same hillside are not the same line, and the finder will not pretend otherwise.
How sustainability is judged
TrailsIQ uses the half rule: trail grade should stay under half the hillside's cross slope, so water sheds across the tread instead of running down it.
That rule alone misbehaves on flat ground — with no cross slope there is nothing to shed across, and a bench or a valley floor would be condemned for being level. So the real threshold is:
the greater of half the cross slope, or 5%
A 6% side slope allows 5% grade (the floor). A 14% side slope allows 7% (the half rule taking over). On gentle terrain the failure mode is ponding rather than fall-line erosion, and outslope and knicks handle that fine at 5%.
Fall-line alignment is flagged separately — a line running straight down the slope erodes regardless of whether it passes the grade test. That check only applies where there is a real fall line to align with: at least 3% grade and at least 5% cross slope. Below that the flag would be noise.
The same thresholds drive the planner's analysis, the route finder's cost function, and the red segments on the map. A stretch that reads red here reads red everywhere.
Reading the analysis
Every planner line carries a terrain analysis, recomputed whenever the geometry changes:
- Grade — the steepness of the tread itself, as a percentage.
- Side slope — the cross slope of the hillside the tread crosses. The input to the half rule.
- Sustained grade — how steep the line stays over a distance, rather than at one point. A brief 20% step over a rock is a different thing from 20% held for 200 feet, and only the second is a maintenance problem.
- Fall-line segments — where the line runs with the slope rather than across it.
Red on the profile means the half-rule threshold is exceeded for that stretch. It is not a veto — plenty of good trail has short steep sections, and armoring and structures exist for exactly that. It is a list of the places that will need attention, and the cost estimate prices them accordingly.
Cost estimates
Every planner line gets a build-cost estimate, derived from its own measured terrain rather than a flat per-mile figure. Tread on 60%+ side slope is priced as structural work because that is what it is.
You can switch cost estimates off entirely. Settings → Workspace modules → Build cost estimates removes them from the planner page, from projects, from the field app, from the comparison table and from the proposal a client sees. Some organizations would rather the figure were not on the screen at all — it is a model rather than a quote, and a number read over somebody's shoulder gets repeated as though it were one. Nothing else about the planner changes: the line, the grades, the sustainability score and the drainage analysis are all still there. The switch is on for every new workspace, and it is per workspace, so a team that quotes for a living and a club that does not can share an account. See Workspace modules.
The rates live in Settings → Trail build rates and are yours to set:
- Tread construction, split three ways by side slope — easy (under 25%), hard (25–60%), and structural (over 60%)
- Rock armoring, per foot
- Rolling grade dips, each
- Stream culverts, each
- Bridges, per foot
- Crew rate per hour, plus finishing hours per foot for each difficulty from Green through Double-black
- A width sensitivity factor, a hand-build multiplier, machine mobilization, and a contingency percentage
Tread width decides which machine can get in, and that decides the price. Machine work and hand work are different rates, so the estimate has to take a view on which one a stretch gets. Width comes first, because it settles the question before the terrain can: a bench is only cuttable by something narrow enough to stand on it.
| Tread | What can build it | Up to side slope | Up to grade |
|---|---|---|---|
| 24″ | Hand only | — | — |
| 30″ | Narrow-gauge mini-excavator | 35% | 20% |
| 3 ft | Mini-excavator | 45% | 25% |
| 5 ft | Standard excavator | 60% | 30% |
| 8 ft | Full-size excavator or dozer | 75% | 35% |
Past a row's limits the machine stops and that stretch is hand work, which is why a line often comes back Mixed — the gentle two thirds machined, the steep pitch and the fall-line sections by hand. Short machine runs get absorbed into the hand work either side of them: nobody hauls an excavator in, walks it down and turns it around for a hundred feet.
A 30″ tread used to be hand-only and is not any more. The narrow-gauge machines trail crews actually own — retracted tracks around 27″ — cut a 30″ bench by sitting on the bench they are cutting. They have their own row rather than sharing the mini-excavator's, because what they do not have is its reach: the same 40% side slope a mini-ex takes in its stride will put a narrow-gauge machine back on foot. If your 30″ lines got cheaper and grew a machine mobilization line, that is why.
You can overrule all of it. The build-method control on a planned trail takes Auto, Hand, Machine or Mixed, and you can mark individual stretches by hand on the map. The table is our guess from the numbers; you are the one standing on the ground.
Branches can be priced with their parent. On a line that has branches, the build-estimate card offers Include this trail's branches in the price. It prices the whole thing as one job: every branch is still measured on its own terms — a hand-built spur off a machine-built parent is priced as hand work — but machine mobilization is charged once instead of once per line, because one excavator gets hauled in once. The card names the saving against pricing them separately, so the number holds up when somebody asks why it is lower than the sum of the parts. The line-item list breaks into a section per trail, each headed with that line's name and its own subtotal, so you can see at a glance which stretch of the price belongs to which piece of trail — the parent first, then each branch. The setting is stored on the trail, not on your screen: the dashboard, the field app and a shared public proposal all quote the same figure.
A branch can have branches of its own, and each switch governs one hop. If you put a reroute on an alternate, that spur is priced into the alternate when the ALTERNATE's switch is on — and reaches the primary's total when the primary's switch is on as well. Turning a switch off takes everything below it out with it, so an alternate marked "not in the price" removes its own spurs from the quote too. The trail's page lists the whole family whatever the switches say — a nested line is labeled with the line it hangs off — because the switches decide what a line COSTS, not whether it exists. The estimate card reports how many branches it actually priced, which is the number to read when the two differ.
Every line has a tick box, and so does the contingency. The estimate is a model, and you are allowed to argue with it. A crew that owns its own machine has no haul-in to charge. A club supplying its own rock does not want the armoring line in the client's total. A job with a signed fixed scope behind it carries no contingency at all. Untick a line and it leaves the price; the card keeps it below the total under Not in this price so you can see what you took out and put it back with one tick.
A line you switch off is absent from the proposal and the contract, not struck through. Those are the client's documents, and a crossed-out row tells them precisely what you decided not to charge them for — which is a conversation you should choose to have rather than have chosen for you. Only your own estimate card shows the excluded lines.
Contingency has three settings and the middle one is easy to miss. Leave it alone and it follows your organization's rate, so changing that rate in Settings moves every trail with it. Type a number and this trail keeps that number whatever Settings later says. Untick it and the trail carries none — which is a decision, and it survives the organization's rate changing too. When you have set it yourself the card says so and offers you the way back.
The setting lives on the trail, not on your screen: the dashboard, the field app, a shared public proposal and a contract draft all quote the same figure. A contract picks it up while it is still a draft and freezes when you send it — adjusting an exclusion afterwards cannot rewrite a document somebody has already signed.
On a line that is pricing its branches with it, the rows are the parent and its branches added together, so a single row can belong to more than one trail. The tick boxes step aside there and the card says where to find them: switch a line off on the trail it belongs to.
The defaults are reasonable US figures, not a quote. Put your own crew rate and your own material costs in before you show a number to anybody — the estimate is only as good as the rates behind it, and a board will ask.
Width matters to the total, which is why the activity profile feeds it: a 10-foot groomed corridor and a 2-foot hiking tread across identical ground are not the same job.
Editing a line
Open a planner recording and use Map editor to work on the geometry directly — drag vertices, insert and delete points, and watch the analysis update as you go.
Beyond point editing:
- Reverse — flip the direction of travel. Worth doing before you analyze a descent you recorded uphill.
- Append tail — keep drawing from the end of an existing line.
- Close the loop — on Draw and in the Map editor, joins the last vertex back to the first in one click, for a circuit. No distance limit here: every vertex on those screens is one you placed. The Field App's recorder has the same button with a cap, because there the two ends are wherever you stopped walking.
- Branch — split a new line off an existing one, keeping the shared section.
- Add branch — open Draw or Suggest with the existing line as the parent. The parent's own work comes with it. Its notes appear as numbered pins, with a numbered list under the map so you can read what each one says; the pins do not respond to clicks on these two screens, deliberately, because every click there is placing a vertex or an endpoint and a note pin sitting on the parent line would swallow the ones aimed at the ground beneath it. The number is how you get from a pin to its text. Its map drawings are replayed too, over the ground they were drawn on rather than as a picture stuck to the screen, so they stay in place as you zoom. A chip row above the map turns either layer off — both start on, and the reason to switch one off is usually that a drawing sits exactly where the new line has to run. The same untappable-pins treatment applies on the split-at-a-vertex picker, where the pins would otherwise cover the vertex dots you are trying to hit.
- Splice — join lines together.
- Swap into parent — promote a branch so it becomes the main line.
- Recompute terrain / analytics — force a re-measure after an edit or after new elevation data has been generated.
Several trails built together belong in a project. The Project box on a planner trail groups it with the other lines going in on the same visit — pick an existing project or start one right there, on the dashboard or in the Field App. The other trails in the group are drawn on the map beside this one so you can see the shape of the job, with a switch to take them off when they are sitting where the new line has to run.
Grouping is not filing. The reason to do it is the price: a project's estimate charges machine mobilization once across every trail in it, instead of once per trail, because the excavator is hauled in once. And a project can be shared as a single public proposal covering the whole job — one link, one map, one number. See Projects and work planning.
Notes can be corrected from the dashboard. Each note in the Notes along the trail list has Edit and Delete. Edit opens the note in place, under the map, so you can see where it sits while you rewrite it — a note typed with a thumb on a hillside is not always the note you want a landowner reading. Deleting one takes its photos with it and cannot be undone, and the pins renumber immediately so the map and the list never disagree about which note is number three.
Map drawings show on the recording's own map. Each entry in Map images has a Show on map button that replays its strokes over the live map, on the ground they were drawn on rather than as a picture stuck to the screen — so they stay put as you zoom and pan. Show all on map does the lot. Drawings start switched on, and switching one off is saved on the drawing itself rather than in your browser — so it is off for everyone, including whoever opens the public proposal link. A drawing saved before capture positions were recorded shows the button grayed out — there is nowhere on the map to put it.
A drawing's title is editable in the list. Click it, type, press Enter. An empty title goes back to Untitled map image. New ones are made from Draw on map in the right-hand column, which opens a full-screen map you can arrow, label and freehand over.
Editing also works from the Field App, so you can fix a line standing on the ground it crosses rather than remembering the problem until you are back at a desk. Edit line there opens a Cleanup panel over the map with the same trims, simplifier and vertex handles.
One thing changes on the map while you are placing or moving points in the Field App: note pins stop responding to taps. They stay on the map, because a note saying wet through here is exactly the context you want while deciding where the line goes — but tapping one no longer opens it, which used to slide the panel up over the line you were working on. This already applied while drawing and suggesting; it now covers editing too. Read a note from the numbered list under the map instead, or leave the edit and tap the pin.
Tap the line itself to add a point — anywhere along it, roughly rather than exactly. The tap does not have to land on the line to the pixel; anything close enough counts, and the new point is inserted into the nearest section rather than at the start. Tap an existing middle point to remove it, and drag any point to move it. The two ends can be dragged but not deleted.
Comparing options
Trail Planner → Compare puts two or more lines side by side — length, climb, grade distribution, sustainability, and estimated cost.
This is the screen for the conversation that actually happens: not "is this line good" but "is this line better than that one, and by how much, and what does the difference cost." Two reroutes around the same wet section are far easier to choose between with the numbers next to each other than one after the other.
The same screen answers a second question when you reach it from a trail's Compare walks button — not "which of these routes" but "the same route, walked more than once, do the traces agree". See Walking a line more than once.
Walking a line more than once
Ground changes and first passes are rough. You walk a line in April with the brush still up, come back in June once it is cleared, and want to know whether the grade through the wet section really holds. Both walks are worth keeping, and they are the same trail.
The Field App's planner list pulls down to refresh, the same as the maintenance list — drag from the top and let go. Worth knowing because the list is the one place a line another crew member recorded shows up, and the app is deliberately quiet about going to the network on its own. Compare sits in that list's header now, beside the close button.
Field App → open the planned trail → Walk it again. It records like any other session and saves as a walk of that trail rather than as a trail of its own. Each walk gets its own color on the map, so two tracings of the same hillside are told apart at a glance, and each keeps its own notes, photos, elevation profile and analysis. They appear under Other walks of this line on the trail — separately from Branches, because they are a different kind of thing.
Each walk has a Show on map button on its row, and Hide all on map in the card's header takes the lot off at once. Five traces of one ridge is exactly when a map stops being readable, and this is a view setting rather than a property of the walk: it is yours, it is not saved, and it changes nothing anyone else sees.
Start it wherever you are. Unlike a branch, a walk does not have to begin on the recorded line — a trailhead a hundred yards off the old trace is fine, and often where you actually park.
A walk is a record of the ground, not extra trail. That distinction is the whole point, and it is enforced rather than left to you to remember:
- It is never in a total. Three walks of one trail is one trail's worth of work. No switch changes this, including the include-branches one — a walk is out of every estimate, on the trail, in the project, and on a proposal. It does have a figure of its own, which is a different thing; see What a walk would have cost below.
- It never appears on anything a client reads. Not the public proposal, not the report, not the poster. A landowner looking at a quote does not want three squiggles over the same hillside.
- It is not counted as a trail. A project with three planned trails and six walks of them still says three.
- It cannot be published to your live trail network. That would put a second trail over the first, with its own maintenance, on one piece of ground. Publish the planned trail it belongs to instead.
- It does not count against your plan's planned-trail limit. Walk a line as many times as it is worth walking.
The one place walks do come along is the GPX download, labeled as walks. That is deliberate: having your previous trace on the handheld while you walk the line again is most of why you kept it.
Saving with no signal
Recording happens where there is no bar of coverage, which is why a save has never needed one. Tap Save out of signal and the line joins the phone's queue and uploads by itself later — nothing is lost, and closing the app is fine.
It is also on the list and the map immediately, in amber, marked On this phone only, and it is the row the app opens on. That is the difference between a line you have saved and a line you can look at: the reason to see a trace the moment you finish it is to decide whether to walk more of it, and that decision is made standing on the ground, not back in signal.
Tap the row and the panel underneath says what is real yet. The length is final — it is measured from the points themselves and does not change when it lands. The elevation gain is from the phone's GPS and is replaced by the terrain figure on upload, so treat it as a rough one. Grade, side slope and sustainability need the server and are simply absent rather than shown as zero, because a zero would read as a measured flat trail.
Continue walking picks the line back up and records onto the end of it, exactly as extending an uploaded trail does — same warmup, same guard about standing near the line. While you are out there the app holds that recording back rather than uploading half a trail; when you save, the whole longer line goes up as one. If the app restarts mid-walk it comes back to it on the next launch and the extension is still part of the same line.
An extension of a trail that has already uploaded queues as its own amber line marked Extension queued, drawn beside the trail rather than merged into it. What is filed and what is still on your phone are different things until the queue drains, and the map says which is which.
Everything queued is counted in the N pending badge in the header, the same as any other offline write — see Field App.
In the rare case the server refuses a queued save — a validation error, or a workspace change since you recorded it — the line stays on your phone. The sync panel behind the pending badge marks it Rejected by the server with the reason code, and offers Retry and Discard. Nothing you walked is ever deleted because an upload failed; discarding is always your tap, never the app's.
Every queued recording in that panel also has a Save GPX button — no signal needed. It hands the walked line out of the app entirely, through the share sheet, so whatever happens to the upload you can always keep the file and import it on the dashboard later.
Reading works the same direction: open the planner once on signal and every planned trail is saved to the phone in full — waypoints, elevation and grade chart, and the build estimate all open with no bars. It refreshes itself quietly on every visit with signal, so the only line that can be missing offline is one somebody created after the last time your planner saw the network.
What a walk would have cost
A walk is a second measurement of the same hillside, and two measurements disagree — about length, about side-slopes, about grade. Those three are exactly what the build estimate is computed from, so what would this walk have quoted is a real question, and usually the one you went back to settle.
Open a walk and its card reads What this walk would cost, with the trail's own figure beside it and the difference between them: +$4,180 (+14%), and the length gap underneath that mostly explains it. The line items are there too, the same breakdown any planned trail gets.
Both sides are one line each. The trail's number here is the trail on its own, even when its page elsewhere quotes its branches in as well — otherwise a bypass off the trail would turn up as a difference between two walks of the same ground.
It is a measurement, not scope, and the product treats it that way. It is in no total, adds nothing to a project, and never reaches a quote, a proposal, a report or a poster. The trail is priced once, on the trail. Two controls that would imply otherwise — Hide build cost from shares and include this trail's branches — are simply not on a walk, because neither has anything to act on there.
If Build cost estimates is off for the workspace, none of this appears, the same as everywhere else.
Putting the walks side by side
Compare walks, on the Other walks of this line card, opens every walk of the trail against the trail itself — the lines overlaid on one map in their own colors, and a column of numbers each.
It reads differently from comparing two alternate routes, and deliberately so. Length, climb and note counts are properties of the trace, not of the trail: a shorter reading is a shorter reading, and one walk beating another at being the same piece of ground is not a result. Those rows are shown as a difference from the trail's own figures — +99 ft, same — rather than scored.
Estimated build cost is one of those measurement rows, and it is worth knowing why. Cost is computed from the length, side-slopes and grades each walk recorded, so between two walks of one line the cheaper column is the cheaper reading — not the cheaper trail. It is shown as a difference against the trail's own figure and never scored, and nothing in that row is extra work or belongs in a quote. The row is on the dashboard; on the Field App it is left off, because filling it costs a round trip per walk and the number is already on each walk's own sheet.
The rows that keep their verdict are the ones you walked it again to settle: average and maximum grade, percentage steep, sustainability, fall-line, drainage breaks. If June's walk says the grade through the wet section holds and April's said it did not, that is the answer you went back for, and the footer counts which walk is better on more of them.
A row where only one column has a figure is marked not yet comparable rather than scored. A walk's analysis lands a moment after the walk itself, so a fresh one can arrive with its length and climb and none of its grade figures. The Better on tally under each column counts only the rows that could be compared, and says how many those were — a walk saved a minute ago is not behind, it is unmeasured, and a score with no denominator cannot tell you which.
It is on the Field App too, on the same trail, under the map: Compare this line with its walks. The walks paint over the trail on the map above the sheet in the colors their columns wear, and the table below reads the same way it does on the dashboard — differences against the trail on the measurement rows, a verdict only on the rows worth one. Reading two traces of your own ground against each other changes nothing, so unlike Merge walks it needs no extra permission: a volunteer who walked the line can see how their trace compares.
Adopting a walk
When one of them is plainly the better line, press Use this walk — on the comparison, on the walk's own page, or as Use this walk as the trail in the Field App. The trail's line becomes that walk's line, and everything hanging off the trail — its branches, its price, its proposal — follows.
Nothing is lost doing this. The line that was there is kept automatically as another walk, named previous line, so a decision you want back is one click away rather than gone.
Merging sections of several walks
Adopting a whole walk assumes one of them is the better line all the way along, and often none of them is: June's trace is better through the wet section because the brush was down, April's is better over the rock band because the GPS had sky. Merge walks, on the same card, builds one line out of a stretch of each.
The editor is a bar representing the trail from start to finish, split into sections. Add switch point cuts the longest section in two and gives the new half a different walk, so the line changes the moment you press it. Drag a handle to move a switch point along the trail, double-click one to remove it, and click a section to choose which walk supplies it. The whole trail is always covered — there is no way to leave a hole in the line — and the map above redraws the assembled line, in black over the walks, every time you change anything.
If nothing on the map is moving, every section still comes from the trail itself. Sections cut out of one line and joined back together reproduce that line exactly, so switch points between them change nothing and Use this as the trail's line stays greyed out — the panel says so when it happens. Pick a walk for a section and the black line moves.
A switch point is a distance along the trail, not a point on a walk. That is the only thing the walks have in common: they are separate traces with different numbers of points, wandering a few yards apart the whole way, so no vertex in one has a counterpart in another. TrailsIQ takes the place you picked and finds the nearest point on each walk to it — measured across the line rather than along it, so two walks that run parallel but start at slightly different spots still get cut at the same place on the ground.
Steps at the switch points are reported, not smoothed away. Where two walks join they are usually a few feet apart, and the panel lists every joint with how far across it is. Small ones are normal. A wide one is a real jog in the finished line and is highlighted — nudging the switch point to where the two traces cross usually closes it. Nothing is quietly interpolated to hide it: a line that reads cleaner than the ground it came from is not a help to whoever builds it.
Merging keeps the trail. Its id, its branches, its project, its proposal link and its notes are untouched; only the line changes, because the merge is a better description of the same trail. The line that was there is kept as a walk called previous line, and the recipe — which walk supplied which stretch — is saved with it, so Merge walks reopens where you left off and a switch point can be moved later rather than the whole thing rebuilt from memory.
It is on the Field App too, on the same trail, under the map: Merge walks into one line. Same three gestures: Add switch point to make one, drag its handle to place it, tap a section to pick its walk. The assembled line draws on the map above the sheet in black over the walks, which is most of why it is worth having on a phone — the person deciding which walk was better through the wet section is usually standing in the wet section, and can look up from the screen and check.
Merging is the one planner action that needs signal. Everything else on the phone queues and syncs later; this one cannot, because the line is measured on the server and merging blind would be a decision made against numbers nobody had seen. Offline it says so and keeps your sections while you wait.
Merging needs the Manage the trail planner permission, like anything else that rewrites a trail's line. Comparing walks does not.
Sharing a proposal
A planner line can be published as a public proposal page — a read-only page showing the line on a map with its stats, carrying your organization's branding, viewable by anybody with the link and no TrailsIQ account.
From a planner recording, enable sharing and you get:
- A share link to copy.
- A QR code you can download as a PNG — for a trailhead sign, a public meeting handout, or a printed proposal.
Sharing is off by default and stays off until you turn it on. You can disable it again at any time and the link stops working.
Turning sharing on or off needs the Manage the trail planner permission — owners and managers have it, and it can be granted to anyone else from Settings → Roles & permissions. Copying or showing a link that is already live is open to the whole team.
A rejected branch stays off the page. Mark an alternate Rejected and it disappears from the shared proposal — map and list both. The page is your pitch, and painting a discarded option beside the line you are proposing invites the reader to compare against something you have already decided against. If you want a reader to see both options, leave both as drafts (or mark one Preferred): only Rejected is filtered.
Choose what the page leads with. Top of the page offers Map image or Live map. Live map shows a real map the reader can pan and zoom, with the line, its branches and the numbered note pins on it — the right choice when the question is where does this actually go. Map image shows a still picture instead, which is the right choice when the page has to survive being printed or forwarded. This choice appears on both the dashboard and the Field App, and is stored on the trail, so both agree.
The picture is one you frame yourself. Under Proposal image, Capture from map hands you the map full-screen, starting fit around the whole trail and its branches. Zoom and pan to the shot you want, capture it, and the annotator opens on it so you can add arrows or labels before it goes public. Retake it after you change the line, or the proposal keeps showing the old shape. Until you take one the page falls back to a simple outline drawing.
Live map opens where you framed the picture. The two options are meant to be two views of the same ground, and only one of them was ever composed by a person — so the live map now starts at the center and zoom you captured from, rather than backing off to fit every line. A reader can still pan and zoom from there; it is a starting view, not a lock. Proposals captured before this, and any whose picture you have cleared, keep the old fit-to-the-whole-trail opening. A reader on a much wider or narrower screen sees a little more or less around the edges — the scale and the middle are what carry over, not the exact rectangle.
It is worth knowing what this replaced, because the old behavior looked deliberate and was not. The page used to lead with your newest map image, and a map image is a drawing — composed at whatever zoom, over whatever ground you happened to be annotating. It was never a picture of the trail, and the usual symptom was the top of the line missing. Existing shared links still fall back to your newest drawing until you capture a real image, so nothing already in somebody's inbox suddenly turned into an outline sketch.
A proposal can carry photos, not just the map. Under the proposal card there is a Proposal photos box. Add the site pictures that explain the job — the creek crossing, the staging area, the rock band the price assumes, last season's finished trail that says what your crew builds. Each one can carry a description. The reader sees a grid of thumbnails and taps any of them to open it full size, description and all, and the same pictures go into the PDF.
You can also add a map image you have already drawn, instead of exporting it and uploading it back. Pick it from Add a map image and the proposal points at the original — so if you re-open that drawing and change an arrow, every proposal showing it changes with it. It also costs you no storage, because the file is already yours and is only counted once. Uploaded photos do count toward your organization's storage, and the box says which of the two each picture is.
Removing a picture that you uploaded deletes the file and gives the space back. Removing one that points at a map image only takes it off the proposal — the drawing stays on the trail it belongs to.
A job's photos live on the project, and a single trail's live on that trail, which is the same split as everything else about the two proposals: each page shows its own.
You can add them from the field app, on the planned trail's own sheet under Proposal photos — which is usually where the picture is. The button opens the camera, and the photo is on the proposal by the time you walk back to the truck. It needs a connection: a photo uploads straight away rather than waiting in the outbox with your tasks, so the app says so up front rather than queueing something that might sit there.
The reader can download it as a PDF. Every proposal page carries a Download PDF button, and it needs no account and no permission — it is there for whoever you sent the link to. The document leads with the map, then the trails and their options, the notes you chose to publish, and the estimate if the page is showing one. It is the same page in a form somebody can keep: a link can be forwarded and lost, and you can stop sharing it, which is right for the live page and wrong for the copy a client is deciding from with two other quotes on the desk beside it.
Which map ends up at the top follows what the page is showing. If you framed a proposal image, that is the picture in the document — you composed it deliberately, and nothing a reader does on the page overrides it. If the page is on Live map and you have taken no picture, the document uses the map as the reader had it on screen, at their zoom and position, with your drawings baked in. So the same proposal can produce two readers two slightly different covers, which is the point: they downloaded what they were looking at.
The numbers in it are ours, not the reader's. Trail names, lengths, grades, notes and the price are read on the server from the same records the page reads, so a downloaded proposal cannot be edited into a document that still looks like it came from you.
Your drawings can ride along. Show map images on the proposal replays them over the ground they were drawn on — so they sit on the right piece of hillside at any zoom, rather than being a picture stuck to the screen. On the live map they are a layer the reader pans around with; in a captured picture they are baked in. On by default when you have any, and switchable from the dashboard or the Field App.
The Live map option only appears on the TrailsIQ map — see The TrailsIQ map. A proposal link is one you have deliberately given away: it can be forwarded, printed as a QR code, and opened any number of times by people you never sent it to. A provider-backed map is metered per open, so a live map on a page like that would eat your organization's monthly map-load allowance on views you never made. Rather than hand you a switch that quietly does that, we leave it out and the page shows your map image. Switch your organization to the TrailsIQ map and the option appears — including on lines where you had already chosen it.
You decide which notes a reader sees. Every note carries a Shows on the proposal page switch, on the dashboard and in the Field App. Notes start visible. Switching one off keeps it in the app for you and your crew and leaves it out of the shared page entirely — not hidden in the page, genuinely absent from it, so there is nothing to find by poking at the page source. This is for the working notes that are exactly right for the crew and not the first thing a landowner should read: wet through here, check with the neighbor before the survey.
The trail's own notes box stays private unless you say otherwise. Map-pin notes are one thing; the free-text Notes field on the trail is another, and it is where working commentary tends to accumulate — including the line TrailsIQ itself writes on a suggested or imported draft. It no longer appears on the proposal page at all unless you flip Show trail notes on the proposal in the share panel. If you had a shared proposal before this change, its notes came off the page — flip the switch if you meant them to be read.
For a printed version there is also a report (a full write-up, also available as markdown) and a poster (a single-page map-led layout) — both made by you, on the dashboard, unlike the proposal PDF, which the reader makes for themselves. Between them, the same line covers a landowner conversation, a grant application and a public meeting without being redrawn for each.
Sending a trail to another organization
A proposal link lets somebody READ a trail. This hands them a copy to WORK on — the line, its notes and photos, its branches, and its map images, dropped into their own Trail Planner as a draft they own.
Useful when a consultant plans a line for a club, when two clubs share a boundary and one has scouted the connector, or when a contractor hands the built alignment back to the land manager.
Creating, withdrawing and accepting transfer codes all need the Manage the trail planner permission — a copy of your planning is real data leaving (or entering) the organization, and that is a decision, not fieldwork. Looking up what a code holds is open to anyone, so a crew member handed a code can still see what it is and pass it to the right person.
How it goes. On the trail, Send to another organization → Create a transfer code. You get something like TIQ-K4RM-9XPT, and a line you can attach to it. Send that code however you already talk to them — email, a message, out loud. They open their own Trail Planner and hit Receive a trail — on the dashboard it is the panel under the list; in the Field App it is inside Bring in a trail, the sheet behind the Import button, next to the picker for importing one of your own trails. Either way they type the code and see what is in it before agreeing to anything: who sent it, what it is called, how long, and how many notes, photos, branches and map images come with it. Then they accept, and it lands.
Both halves work from the Field App as well as the dashboard, which is the point of reading a code out over the phone while two people are standing on the ground it crosses. The one thing that needs signal is the moment itself: a code has to be created on the server to mean anything, and accepting copies real files, so neither queues for later the way a note or a drawing does. The app says so rather than pretending to have done it.
It is an offer, not a delivery. Nothing appears in anybody's account until a person there accepts it. That is deliberate: one organization should not be able to write rows into another's account, any more than you can let yourself into somebody's office to leave a folder on their desk.
A code works once, expires after 30 days, and can be withdrawn any time before it is used. Sending the same trail to three organizations is three codes — which also means the record of who received what stays unambiguous.
They get a copy, and it is theirs. Editing it changes nothing on your side, and editing yours changes nothing on theirs. The photos become their files, counting against their storage rather than yours, so nothing breaks if you later delete the original. Their copy carries a From {your organization} badge, which matters more than it sounds: the numbers on it were measured against YOUR build rates, and its notes were written by people they cannot ask.
What does not travel, and why:
- The project it was grouped under — that is your grouping of your work.
- Any live proposal link. A share token is not transferable; they mint their own if they want one.
- The proposal image, which is a picture of your map with your settings on it.
- Its status. It arrives as a draft however you had it marked, because "preferred" is a decision about your pipeline, not theirs.
Send the parent, not a branch. Branches go with their parent automatically; offering one on its own is refused, because half a trail is not a thing anybody can work on.
Turning a plan into a trail
When a line is agreed and built — or when you simply want it in the live network — use Export to trail. That creates a real trail from the planner geometry, at which point it behaves like any other trail: conditions, maintenance, infrastructure, the public hub, all of it.
The planner recording stays where it is. Exporting copies the line forwards, it does not consume it, so the planning history behind a trail remains readable afterwards.
You can also import an existing trail into the planner to work on a reroute of something already built, without touching the live trail until the reroute is settled.
Publishing needs the Manage the trail planner permission — it creates a real trail, with everything that follows from that.
GPX in, GPX out. Download GPX on a trail's page carries the line, its branches (each as its own named track) and every note as a pin — the file you hand an excavator operator, load into a handheld, or open in Gaia or Avenza to navigate to the flag line. And the planner list's Import GPX button goes the other way: a .gpx or .kml file — a consultant's proposed alignment, a track logged on any device — lands as a fresh draft, with elevations filled in from terrain data when the file carries none, and the same analysis every drawn line gets.
Common gotchas
- Deleting a trail keeps its branches. They become standalone recordings — the scouted lines survive, they just stop being branches of anything. And deleting or re-lining somebody ELSE's recording needs the Manage the trail planner permission; your own are always yours to bin.
- The planner is not your trail network. Nothing you draw appears on the public hub, in trail conditions, or on the field app's trail list until you export it. This is deliberate — half the point is somewhere to think out loud.
- A relaxed result is telling you something. When Suggest reports which constraint it had to loosen, that is the terrain answering your question. Loosening the constraint yourself and re-running gets you the same line with no warning on it, which is worse.
- Estimates use YOUR rates, and the defaults are not yours. Set Settings → Trail build rates before quoting anybody.
- The first line on ground you have never worked is slower, and the overlays trail it. This is only about NEW ground — somewhere well away from your existing trails, that nobody in your organization has planned on before. On and around your own network it does not apply at all: everything there is already prepared, and a Suggest comes back as fast as any other. Out on new ground, the numbers are still right — grades, side slope, sustainability and the cost estimate are measured against real elevation wherever you plan. What it costs you is time, because that elevation is being fetched rather than read from what we already hold, so the first Suggest there can take the better part of a minute. Contour lines and slope shading are the part that genuinely is not there yet: they stay blank over ground nobody has planned on, with their toggles still on. Drawing there sets that preparation going by itself, and the overlays fill in within a few minutes — no reload, nothing to press. Every line after the first one on that hillside is quick, for you and for everyone else in your organization. See Terrain analysis.
- If elevations are missing, the planner says so — believe it. Where some points could not be resolved, the result carries a line naming how many. Those sections were measured against flat ground, so their grades are not real, and on Suggest the line's shape through them is not either. It usually means generation for that area has not finished; wait a moment and run it again rather than acting on the numbers.
- Recording uphill and analyzing downhill. Grade sign follows the direction of the line. If you walked it the wrong way, Reverse before you read the profile.
- Grouping trails changes the price, on purpose. Once two machine-built trails are in the same project, the project's estimate charges one machine mobilization rather than two. Each trail's OWN page still quotes its own haul-in, because on its own that is what it would cost — so the two figures differ, and the project's card names the difference rather than leaving you to find it.
- A transfer is a copy, not a link. Once they accept, the two trails are separate. Fix a mistake on yours after sending and they will not see it — send a new code, or tell them.
- A shared proposal is genuinely public. Anyone with the link can see it — that is the point, but check the line is one you want seen before you print the QR code.