Skip to content

General settings

General settings cover the core company-wide defaults that drive billing, dispatch, and travel-cost calculations across FSM Navigator®. These values apply to every user in your company.

Navigate to Settings → General to manage these options.

Owner access required

Only users with the Owner role can modify general settings. The Onboarding Mode card is also visible to the Owner only. See Roles and permissions for details.


Currency

The currency for your company is locked to US Dollar (USD) at this time. All invoices, payments, payouts, and financial reports are calculated and displayed in USD.

Field Value
Currency US Dollar (USD) — $

Currency

US Dollar is the only currency available. If your business operates in another currency, please contact support.


Distance unit

Choose whether distances are displayed and calculated in Miles or Kilometers. This setting affects:

  • Mileage shown on jobs and travel reports.
  • Fuel-cost labels (per mile vs. per kilometer).
  • Distance figures used by intelligent dispatch when matching the closest technician.
  • Travel-savings reporting.
Option Typical use
Miles United States, United Kingdom, Canada
Kilometers Most other regions

Changing your distance unit

  1. Open Settings → General.
  2. Select Miles or Kilometers.
  3. Click Save.

The fuel-cost field below updates its label automatically (e.g., Fuel Cost per Mile becomes Fuel Cost per Kilometer).


Fuel cost

Set your average vehicle fuel cost per mile (or per kilometer, depending on the distance unit selected above). This single number drives travel-cost estimates and travel-savings reporting across the platform.

Field Range Default
Fuel Cost per Mile / Kilometer $0.01 – $10.00 The IRS standard mileage rate in effect

The hint under the field shows the IRS standard mileage rate in effect. When the IRS has announced a new rate, the hint also shows the new rate and the date it starts. If you keep the IRS rate, trips from that date use the new rate automatically. If you entered your own figure, it stays as it is until you change it.

Owners also get a notification and an email when the IRS rate changes: when a new rate is announced, on the day it starts, if an announced change is cancelled, and if a rate already in effect is corrected. If your company keeps the IRS rate, the message says it updates automatically. If you entered your own figure, the message asks you to review it and links to this page. You can turn off these emails under IRS Mileage Rate Updates in your email preferences.

How to estimate your fuel cost

To set a figure for your fleet, divide your weekly fuel spend by the total miles your technicians drove that week. Update this value occasionally as fuel prices change.

Updating your fuel cost

  1. Open Settings → General.
  2. Enter your average cost per mile or kilometer.
  3. Click Save.

The number is shown alongside live travel-cost examples on the same page so you can see the impact before saving.


Default technician hourly rate

This is the hourly rate you bill customers for technician time. It pre-fills the labor line on estimates and on invoices generated from a job.

It is a billing rate, not a cost. Job profitability does not use it: what an hour of each technician's time costs your company is set separately under Technician cost rates on the Performance Dashboard's Profitability tab (Pro and Enterprise plans). See Job profitability.

Field Range Default
Default Technician Hourly Rate $1.00 – $500.00 $75.00

Updating the default rate

  1. Open Settings → General.
  2. Enter the hourly rate.
  3. Click Save.

Existing invoices and historical reports are not affected — the new rate applies to future cost calculations.


Estimate labor rate

Some companies quote customers at one rate and pay technicians at another. This optional setting is the rate used to price labor lines on estimates, so you can set your quoting rate without changing what you pay.

Field Range Default
Estimate Labor Rate $1.00 – $500.00 (blank)

Leave it blank and estimates quote at your Default Technician Hourly Rate — exactly as they did before this setting existed. Fill it in only when the two numbers should differ; the gap between them is your quoting margin, and you can see both side by side on the same screen.

Setting or clearing it

  1. Open Settings → General.
  2. Under Billing & Pricing, enter the rate — or clear the field to go back to using the default technician rate.
  3. Click Save.

Clearing the field is a real choice, not an error

An empty Estimate Labor Rate means "use my default technician rate". It never means "quote labor at $0.00".

Existing estimates keep their prices

Changing this rate affects labor lines generated from now on. Estimates you have already generated keep the prices they were created with — regenerate an estimate if you want it repriced.


Owner dashboard notifications

Toggle whether the Owner receives alerts on the dashboard for critical company events such as:

  • SLA breaches and overdue jobs.
  • Missed technician check-ins.
  • Low-inventory alerts.
  • Daily summary digests.
Field Default
Enable Owner Dashboard Notifications Off

When this is off, dashboard alerts still appear on screen for the Owner — only the email side of these notifications is suppressed. Turn it on if you want the Owner to receive emails for these events as well.

Turning Owner notifications on or off

  1. Open Settings → General.
  2. Toggle Enable Owner Dashboard Notifications.
  3. Click Save.

Onboarding mode

Onboarding mode is a temporary setting that temporarily raises your API rate limits so that bulk user imports, training sessions, and rapid first-week setup do not trip the platform's anti-abuse limits.

Owner-only card

The Onboarding Mode card is visible only to the Owner. Other roles will not see it on the General settings page.

Field Options Recommended
Duration 24 hours, 48 hours, 72 hours, 1 week 48 hours
API rate limits Temporarily increased during onboarding —

When to enable onboarding mode

  • Bulk user imports — adding many users in a short window.
  • Group training sessions — when a room full of new users will be exercising the app simultaneously.
  • Rapid initial setup — the first day or two while you load customers, jobs, and inventory.

Enabling onboarding mode

  1. Open Settings → General.
  2. Scroll to the Onboarding Mode card.
  3. Choose a Duration (24 hours, 48 hours, 72 hours, or 1 week).
  4. Toggle the switch on.
  5. The card shows a live countdown until the mode expires.

Onboarding mode automatically expires after the duration you selected — you do not need to remember to turn it off. You can also disable it manually at any time by toggling the switch off.


Hold reasons

When someone puts a job on hold, on the web or in the mobile app, they pick a reason from a list. FSM Navigator starts you with six reasons: Waiting on parts, Customer not available, Waiting on approval, Weather, Access issue and Customer requested changes. Other is always offered as well, and it asks for a short note so the office knows what happened.

When a customer selects Reject Work on a completed work order in the customer portal, the work order goes on hold with Customer requested changes, and the customer's comment is kept as the note. If you rename that reason, your name is used. Hiding it only removes it from your team's list; a customer's rejection still records it.

You manage the list under Settings → General → Hold reasons:

  • Rename a reason — type the new name in its box and select Save name. To go back to the original name of a standard reason, clear the box and save.
  • Hide a reason — select Hide. It stops appearing when someone puts a job on hold. Jobs that were already held for that reason keep it. Select Show to offer it again.
  • Add your own reason — type it under Add a reason and select Add reason. You can offer up to 30 of your own reasons at once; hide one you no longer use to make room.

Other cannot be renamed or hidden.

Changes reach phones on their next sync

The mobile app keeps a copy of your list so technicians can put a job on hold without signal. A renamed or new reason shows up on a phone the next time it connects.


Settings summary

Setting Where to find it Who can change it
Currency (USD, locked) Settings → General Owner
Distance unit Settings → General Owner
Fuel cost per mile / kilometer Settings → General Owner
Default technician hourly rate Settings → General Owner
Owner dashboard notifications Settings → General Owner
Onboarding mode Settings → General Owner
Hold reasons Settings → General Owner

Frequently asked questions

Can I switch currency to something other than USD?

Not at this time. Currency is locked to US Dollar across all companies. If your business works in another currency, contact support.

Does changing the distance unit affect historical jobs?

The unit change affects how distances are displayed going forward. Historical mileage values stored on past jobs are not retroactively converted.

Does changing this rate change my job profitability figures?

No. This is the rate you bill customers. Profitability compares what you billed with what the work cost you, and the cost side uses each technician's own cost rate, set under Technician cost rates on the Performance Dashboard.

Is onboarding mode safe to leave on?

It is automatically capped at the duration you selected (24 hours, 48 hours, 72 hours, or 1 week) and expires on its own. We recommend turning it on only while you are actively onboarding so normal rate limits resume protecting the account afterward.

Will Owner dashboard notifications spam my inbox?

The notifications are reserved for material events — SLA breaches, overdue jobs, missed check-ins, low inventory, and daily summaries. If you do not want them by email, leave the toggle off; you will still see the alerts on the dashboard.