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
- Open Settings → General.
- Select Miles or Kilometers.
- 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
- Open Settings → General.
- Enter your average cost per mile or kilometer.
- 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
- Open Settings → General.
- Enter the hourly rate.
- 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
- Open Settings → General.
- Under Billing & Pricing, enter the rate — or clear the field to go back to using the default technician rate.
- 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
- Open Settings → General.
- Toggle Enable Owner Dashboard Notifications.
- 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
- Open Settings → General.
- Scroll to the Onboarding Mode card.
- Choose a Duration (24 hours, 48 hours, 72 hours, or 1 week).
- Toggle the switch on.
- 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.
Related guides
- Company information — set your company name, address, and timezone
- Branding — upload your company logo
- Notification preferences — choose which alerts you receive
- Roles and permissions — understand who can access settings