Admin Settings That Affect Drivers

7 min read

Updated July 29, 2026

SettingsAdminDispatcherDry Run FeeLocation TrackingRoll-Off

Need more help?

Most of the driver app's power comes from choices admins and dispatchers make at the organization level. This is the settings tour for the office side.

Driver Location Tracking

Settings → Driver Location Tracking

On: driver phones report position to dispatch every 30 seconds, from any tab (not just the Map view). ETAs on the customer's on-my-way SMS update accordingly.

Off: driver position stays on the phone. Nothing leaves the device.

Rule of thumb: turn this on. The customer's tracking link goes cold without it, and the dispatch cockpit can't route around trouble.

Dry-Run / Wasted-Trip Fee

Settings → Company Settings → Dry Run Fee

Numeric field (dollars, e.g. `85.00`).

When set, any driver-reported issue that leaves the job open (blocked access, locked gate, customer refused, etc.) auto-stages a fee line on the job with `source: dry_run_fee`.

The office reviews the fee on the invoice draft and can delete it before sending.

Leave blank if you don't automatically charge dry runs; reports still fire and dispatchers still see them, they just don't stage a fee.

Roll-Off Rental Term Defaults

Settings → Roll-Off Defaults (also editable per customer / per contract).

Included days how long the rental runs before day-overage kicks in. 14 is a common default.

Daily overage rate the per-day cost after included days run out.

Included tons weight included in the base haul.

Overage per ton the per-ton overage rate.

Disposal passthrough whether the landfill's cost per load flows to the customer.

Drivers see all of this on the roll-off context card and never bill it themselves, but everything they enter (weight ticket, disposal site) uses these defaults to calculate the invoice.

Disposal Sites

Admin → Disposal Sites

Add every landfill, transfer station, and dump site your drivers use.

Name and address.

Type liquid (gallons) or solid (tons).

Per-load cost or per-ton rate for passthrough billing.

Accepted waste types used for driver-side dropdown filtering.

The driver's Weight Ticket → Disposal site dropdown pulls from this list.

Rate Cards and Service Bindings

Admin → Rate Cards and Services

Every service and product needs a rate card row and a service binding; the app maps a job's line items to the right template automatically.

Templates drive the completion screen. If a template isn't attached, the driver gets Mark Complete with no form.

Report Templates

Admin → Report Templates (the template builder)

Configure the per-service report the driver fills out. Field types include text, long text, number, date, date-time, toggle, checkbox, single-select, multi-select, radio, photo, multi-photo, before/after photo pair, signature, and gallons captured.

Set `required: true` on fields the driver must fill. Use `show_if` conditions to hide fields until another is answered. Some field types (repeaters, defect logs) fall back to a text box on mobile; use them for anything the driver needs to record but not gate on.

Notification Preferences (Org)

Admin → Notifications

Admins can turn off email/SMS delivery org-wide for specific notification categories, set quiet hours (nothing goes out between, say, 8 PM and 6 AM), and configure who receives which categories by role. Drivers can further filter their own notifications in their profile.

Driver Roster

Team Management → Users

Invite a driver by email; they get a sign-in link.

Set their role to `driver`.

Assign vehicles and territories.

Set birthday, emergency contact, home base (or let the driver fill their own).

The `is_active` toggle is admin-only. It's not editable on the driver's own profile.

Fleet & Vehicles

Admin → Fleet

Add vehicles with type, capacity, license plate, VIN.

Configure truck skills `containers`, `sanitation`, etc. used by the route optimizer to match jobs to trucks.

Set the vehicle's expected tank capacity for pump-out disposal blocking.

Job Type Vocabulary

Nine job types are supported in the database. Five appear in the wizard by default:

Delivery drop a container.

Pickup final pull.

Service recurring service (portable toilets, front-load).

On-site survey a scoping visit, no bill.

Swap exchange containers at the same site.

The other four (`cleaning`, `maintenance`, `return`, `partial-pickup`) exist for legacy compatibility.

Firebase Push (Native App)

Native push notifications (FCM/APNs) require Firebase configuration.

Set the `FIREBASE_SERVICE_ACCOUNT` env var (or the three-var breakdown) in your hosting environment.

Push delivery reports at `/api/notifications/health` (admin route).

Without it, drivers still see bell notifications; push doesn't ring their phone.

Roll-Off Rentals Ledger

Admin → Roll-Off Rentals

The office's control panel for every rental term: KPI bar (open, closed, days-overage, tonnage-overage), term rate editor, schedule a swap or final pickup, add manual fees (damage, contamination, wasted trip, custom), and generate the final statement. Driver-side, everything they submit (delivery confirmation, swap, weight ticket) flows here.

Notification Health

Admin → Notifications → Health

Which channels are configured.

Last 24 hours of delivery stats.

Bell channel is always on. Email needs a Resend API key. Push needs Firebase configured. SMS needs Twilio.

If drivers or dispatchers say "I never got the push," this is the first place to look.

Admin Settings That Affect Drivers

Need more help?

Admin Settings That Affect Drivers

Driver Location Tracking

Dry-Run / Wasted-Trip Fee

Roll-Off Rental Term Defaults

Disposal Sites

Rate Cards and Service Bindings

Report Templates

Notification Preferences (Org)

Driver Roster

Fleet & Vehicles

Job Type Vocabulary

Firebase Push (Native App)

Roll-Off Rentals Ledger

Notification Health

Was this article helpful?

Related Articles

Need more help?

Driver Location Tracking

Dry-Run / Wasted-Trip Fee

Roll-Off Rental Term Defaults

Disposal Sites

Rate Cards and Service Bindings

Report Templates

Notification Preferences (Org)

Driver Roster

Fleet & Vehicles

Job Type Vocabulary

Firebase Push (Native App)

Roll-Off Rentals Ledger

Notification Health

Was this article helpful?

Related Articles