MileWorks Support

Contact: [email protected] · We answer within 2 business days.

What MileWorks is

MileWorks is a fuel, EV-charging and mileage log for every kind of car: gas, diesel, hybrid, plug-in hybrid, electric and hydrogen. Log each fill-up or charge and see the fuel economy or efficiency your car really gets, against its official EPA rating, and what every mile costs. Maintenance, other car costs and business mileage live in the same log.

Your log stays on your phone: there's no account, no ads and no ad tracking. See the privacy policy. Where its data comes from, with the credit each source asks for, and the licences of the open-source code in it: data sources and licences (also in the app: Settings → Data → About).

Getting started

1. Add your vehicle. Tap Add vehicle on the Dash (or Garage → Add vehicle for the next ones). Under it, the Dash also offers Where do you drive? (optional): choose your country (and, if you like, your US state, Canadian province, Australian state, New Zealand region, Japanese prefecture or Korean province or city; in Europe, the country, UK nation or territory) to preset your units, currency and date format. Under that are your units (distance, fuel, fuel economy and currency): change any of them, with or without a region, before you add the vehicle so its numbers go in the units you want (the vehicle form shows them, with Change). Pick it from the EPA list (year → make → model → engine) to get its official ratings and, for many models, the tank size. Or type it in (heavy-duty pickups and vans over 8,500 lb aren't on the EPA list, nor models sold only outside the US: their MPG comes from your fill-ups as any car's does), with a target of your own (the app calls it your target, never the EPA's, as it does a rating you change after picking). Give it a paint color: its numbers and charts use that color everywhere.
2. Starting odometer. Set it only if the tank was full at that reading (for a new car delivered full, 0 or its delivery mileage). Otherwise leave it blank: your first full fill-up is where the log starts.
3. Log as you go. Tap + at the bottom: Fill-up, Charging, Maintenance, Expense, Refund, Odometer reading, Border crossing, Trip or Gig pay (in the phone app, Record a trip too), or Trip cost to price a drive before you go. For a fill-up, enter the odometer (never the trip meter), any two of amount, price and total (the third is worked out), and whether you filled the tank.
4. Let the phone help. Scan the pump's screen, the odometer or the receipt (fill-up form → Read it from a photo): it reads on its own, checks the numbers (the pump's gallons × price has to make its sale), and shows you what it read; Use these numbers fills them in. Miles or kilometers, gallons or liters, the currency the receipt prints, receipts in English, French, Spanish and German. A maintenance visit or expense can Read the invoice, and the vehicle form can Scan the VIN barcode. Use my current location fills in the station and address.
5. Look around. The Dash sums things up, History shows every entry as a ticket, Stats has the charts, and the Passbook (top of Stats) keeps your lifetime record. Settings is the gear at the top right; Help is the ? beside it: a search, Your first week, topics by what you want to do, each a list of short answers, and Asked most for the things owners ask most. On each tab the ? opens the part about it.
6. More than one vehicle? Add each in the Garage (Lite holds two; Plus any number). Tap their cards, or the chips at the top of the Dash, History and Stats, to choose which you see: several together are combined, each worked out on its own odometer. Each vehicle's paint color marks its entries and charts everywhere.

Fuel economy

How does MileWorks measure MPG?

With the full-tank method, the standard way to measure it at the pump: fill the tank until the pump clicks off, and at the next full fill-up MileWorks divides the miles on the odometer since the last full fill-up by all the fuel added in between.

Example: you fill up at 10,000 miles, add 4 gallons at 10,150 miles without filling up, and fill up again with 6 gallons at 10,400 miles. That's 400 miles on 10 gallons: 40 MPG.

In kilometers, the same tank reads in L/100 km or km/L, whichever you choose.

What about partial fill-ups?

Mark a fill-up Partial whenever the tank isn't full. Its fuel is added to the next full tank, as in the example above, so the result stays right. Mark a fill-up Full only when the pump clicked off.

Why isn't my first fill-up counted?

The fuel it put in replaced fuel burned before you started logging, so there's nothing to measure yet. It's shown in History, and its fuel is left out of fuel economy and cost per mile; what you paid still counts in your spending. A new car delivered with a full tank can start at its delivery odometer instead (the vehicle's Starting odometer). So your first MPG shows at your second full fill-up.

What counts in "miles driven"?

Every odometer you log. Miles driven is one figure everywhere (the Dash, the Garage, Stats, the Passbook and the PDF reports): from a car's first odometer reading to its latest, counting the odometer of every fill-up, charging session, maintenance visit, odometer reading, trip and expense. Fuel economy is different: it stays on the measured tanks, full fill-up to full fill-up.

Why does my number differ from the car's display?

Most car displays read a few percent better than the pump. MileWorks uses what actually went into the tank. If you'd like to see the difference, turn on dash accuracy in Settings → Display (it's off by default).

A tank reads far too good or too bad

That usually means a missed fill-up or a mistyped odometer. MileWorks flags it in History rather than letting it skew your numbers: add the missing fill-up, fix the reading, or say nothing's missing.

Plug-in hybrids and electric cars

• An electric car's efficiency (mi/kWh, kWh/100 km or km/kWh) is the distance between odometer readings over the kWh charged in between. It counts every kWh the charger delivered, losses included, so it reads lower than the car's own display.
• A plug-in hybrid's pump MPG includes the miles it drove on electricity. MileWorks also shows its gas-only MPG, its electric miles and MPGe over all the energy it used. Add the electric miles from the car's trip screen at each fill-up for an exact split; without them it's estimated from your charging.
• Home charging can be logged session by session or as a total for a period. Set your home rate (with time-of-use periods, if your plan has them) in Settings → Prices → Home charging, and home charges are priced for you. Stats → Charging shows where you charge (home, work, public, DC fast), and Stats → Habits (Plus), under Charging habits, shows when you charge and how much of your home charging was off-peak (from sessions logged with the time they started; a monthly total has no time of day).

Rental and borrowed cars

• Add a rental or Add a borrowed car in the Garage (Plus; your own cars stay free to add): the company, or whose car it is, where and when you picked it up, and its odometer in miles or km, as its dash reads.
• While it's out, new fill-ups, charging and expenses start on it. Return on its card takes the date, time and odometer you handed it back at: its entries stay in History, Stats and every export, and new entries go back to your own cars. Undo return puts it back out (a return with photos or notes stays, as an odometer reading).
• Condition photos at pickup and at return stay on your phone with the car; a backup doesn't carry photos.
• A borrowed car can carry what you agreed with its owner (an amount once, a week or a month, insurance, a rate per mile or km). Settle up works out what's owed for its days and distance, less what you've logged as Paid to the owner; the fuel you bought is listed apart. Return and Settle up work at every level.
• With the automatic region (Plus), the pickup counts as where you are, like a border crossing, and the return hands the region back to your own cars. The tax tools give a rental or borrowed car no rate per mile: its costs count at its business share.

Backups and moving to a new phone

Where is my data?

On your phone. MileWorks has no accounts, no server and no cloud sync yet, so keep a backup. Your phone's own backup (iCloud or Google's) may also copy it to your account.

How do I back up?

• Export everything (free): Settings → Data → Your data → Export everything (CSV). Save the file somewhere safe (email it to yourself, or save it to a cloud drive). It holds every vehicle, every entry and your settings (not the reminders or the welcome messages' switches and waits: set those again on the new phone).
• Automatic backup (MileWorks Plus): Settings → Data → Automatic backup. Once a day, when you open the app, it saves a fresh copy on the phone, where your phone's own backup can pick it up. On iPhone you'll find it in the Files app (On My iPhone → MileWorks). On Android you can also choose a folder, for example in a cloud-storage app, for a copy off the phone. Choosing another folder moves the backup there, deleting the app's file in the folder before; Stop saving to this folder deletes it from the folder.

Photos and receipts aren't in the CSV file. They stay on the phone.

How do I move to a new phone?

The sure way, between any two phones (iPhone or Android):

1. On the old phone: Settings → Data → Your data → Export everything (CSV), and save the file where the new phone can reach it.
2. On the new phone: install MileWorks, then Settings → Data → Your data → Import a CSV and pick the file. Entries already in the log are skipped, so importing twice does no harm.

Your phone's own transfer or backup may also bring MileWorks across, photos included when moving iPhone to iPhone or with Android's cable or Wi-Fi transfer. Android's cloud backup leaves photos and receipts out because of Google's size limit. Export everything first anyway.

I deleted something by mistake

If the automatic backup is on: Settings → Data → Automatic backup → Restore a backup from this phone. It keeps the latest copy, the one before it, and, if your log ever shrinks to under half, a copy from before the drop. Restoring adds what's missing; nothing already in the log is doubled.

Importing from other apps

MileWorks reads the CSV exports of Fuelly, Fuelio, Drivvo and Road Trip MPG (free, in every level):

1. Export your history from the other app:
   • Fuelly: the website's export or the app's export.
   • Fuelio: a vehicle's backup CSV (unzip it first if it comes as a zip).
   • Drivvo: History → export.
   • Road Trip MPG: Share → CSV.
2. In MileWorks: Settings → Data → Your data → Import a CSV, and pick the file.

Fill-ups, charging, services and other costs come in, in your units, and each vehicle is added to the Garage (or put on the vehicle you choose). On Lite with two vehicles already in use, a vehicle added this way is parked, and MileWorks says so before it imports. A fill-up the other app marked as following a missed one stays out of fuel economy, as it should. Import a CSV also reads a plain spreadsheet with a date, an odometer and the fuel and total for each fill-up.

Fuelly, Fuelio, Drivvo and Road Trip MPG are trademarks of their owners; MileWorks isn't affiliated with them.

Units, regions and currencies

• Region (Settings → Region): North America (the United States with your state or territory, Canada with your province or territory, Mexico with your state, or a country of Central America or the Caribbean), Europe (an EU country, among them France's overseas regions such as Réunion and French Guiana; a UK nation, Crown Dependency or Overseas Territory such as Jersey or Gibraltar; or elsewhere in Europe, Russia and Ukraine among them, with Greenland, the Faroes, Aruba, Curaçao and France's Pacific islands), Oceania (Australia with your state or territory, New Zealand with your region, or a Pacific country or territory) or Asia (so far Japan with your prefecture, or South Korea with your province or city). Most countries have their states, provinces, prefectures, regions, counties or parishes to choose from too, optional (Bavaria, Oaxaca, Saint Andrew, Tokyo); a long list has a search. A territory is listed with the country it belongs to, on the continent of that country's capital. It sets your units, currency and date and time formats in one go, and brings what's local: in the US your state's average fuel and electricity prices, in Canada NRCan's official ratings beside the EPA's and your province's average fuel price, and your part of the world on the Passbook's map. It's optional: the Dash offers it before your first vehicle, with your units under it (MileWorks doesn't guess it from your phone). Without one, the app is in the units you pick: miles, gallons and US dollars until you do. Once chosen, its flags (your country's, then your state's, province's, prefecture's or UK nation's, or a Crown Dependency's or territory's own after the UK's; in the EU, the EU's, then your country's and your state's) show at the top left of the Dash, History, Stats, Garage and Settings; tap them to change it. Northern Ireland has no official flag of its own, so by default the UK's shows alone; Northern Ireland's flag in Settings → Region can show the Union Flag, the Ulster Banner, the Irish tricolour, St Patrick's Saltire or the Flag of Ulster with it instead (where it's offered: below). New Zealand's regions and most of France's have no official flags either, and the app doesn't have every state's or province's flag yet (Mexico's, Spain's, Italy's, South Korea's, the Czech Republic's…): there your country's shows alone, and the region lists show the code. At the top of Settings → Region, Set by me (the default) keeps the region where you chose it; Automatic (MileWorks Plus) moves the flags, the state or province for the average prices and the Passbook's map to where your newest entry with a place was: a fill-up, charging session, odometer reading, trip (where it ended), maintenance visit or expense (from its own position or address; nothing is looked up), a car's purchase (where it was bought), or a border crossing (the place you chose), while your currency, tax rules, NRCan's ratings and recalls stay on the region you set. On Current your units and date format follow you: the units of the country your newest entry is in, back to yours in your own region (with no home region, the region you set counts as home: Home and away, below). + → Border crossing (free) logs the odometer and the country (and state or province) you're entering: it counts as an odometer reading, and following takes the place you chose, never the phone's spot (at a border the maps can't tell the side); with following off, the form offers to turn it on. The Dash then welcomes you there, with what changed (the units on Current, the side of the road, whose average fuel prices): a card for a new country, and one for a new state, province or other region (an ordinary entry there too), with your log's count on a first visit ("Montana is the 7th US state in your log."). Settings → Region → Welcome messages turns either off and sets Not again within (15 minutes) and Welcome back after (an hour). After 3 entries in a row somewhere that isn't your region, the first and the newest a week or more apart, the Dash asks Moved there?: Make it my region sets its units, currency and date format as Settings → Region does (asking first about the currency), your old region becoming your home region if you have none (Home then shows its usual units and formats), and says what it set; Not a move puts it away until an entry is back in your region. Under the region you set (and your home region), Settings → Region says which side of the road it drives on; when your newest entry is in a country that drives on the other side from home, the Dash says so ("Japan drives on the left, unlike home."), until you tap Got it (it comes back once you've been somewhere else). In the region lists each place's code sits beside its flag (OK, QC, DE). The United Kingdom's code is GB, its ISO country code. With your region in the UK or one of its territories, Ireland, or a Commonwealth country or its territories (Canada, Jamaica, Malta, Australia, Fiji…), Settings → Region can show UK instead, the code the EU and the UK's own car stickers use, and offers Northern Ireland's flag; anywhere else GB and no flag for Northern Ireland apply. With your region in the Czech Republic or Slovakia, Settings → Region can call it Czechia instead of the Czech Republic, wherever the app names it; in the Czech Republic it can also show the regions' letters from registration plates (A for Prague) instead of their ISO numbers (10).
• Home and away (MileWorks Plus): add a Home region in Settings → Region, where you're from, under the region you set. Then Current or home chooses, for each kind of unit (distance, fuel, fuel economy, money, and the date with the clock), whether it's shown as where you are or as at home. Current is your own units at the region you set (in another country with the automatic region, that country's, shown only: your settings don't change), and for money always your own currency. Following with no home region, the region you set counts as home, with your own units. Home is the home region's units and currency, every amount converted at its own day's rate, never today's. Show both puts the other one in brackets, smaller, under the big numbers: 6.2 L/100 km over (38.0 MPG); not in charts, tables, CSVs or PDFs. Money shows one currency at a time, and totals are never in brackets: a single entry's amount can show the other currency at the rate it was documented with on its own day, never today's. Nothing logged is converted or changed: switch back any time.
• Units: miles or kilometers; gallons or liters; MPG (US), MPG (UK), L/100 km or km/L. Electric efficiency follows: mi/kWh, kWh/100 km or km/kWh. Change any of them on its own, any time: your log converts, nothing is lost.
• Currencies: every one of North America, Europe and Oceania, and Japan's and South Korea's: US, Canadian and Mexican dollars and pesos, Central America's and the Caribbean's (the quetzal, lempira, córdoba, colón, the Belize, Bahamian, Barbadian, Jamaican, Trinidad and Tobago and East Caribbean dollars, the Cuban and Dominican pesos, the gourde), the euro, the pound, and the Swiss, Czech, Polish, Hungarian, Romanian, Swedish, Norwegian, Danish, Icelandic and Turkish currencies, the Balkans', Moldova's, Ukraine's, Belarus's and Russia's (the lek, convertible mark, denar, dinar, leu, hryvnia and rubles; the Bulgarian lev for what was paid before the euro); Australian and New Zealand dollars and the Pacific's (the Fijian and Solomon Islands dollars, the kina, paʻanga, tālā, vatu and CFP franc); the territories' (Gibraltar, Falkland Islands and St Helena pounds, Bermudian and Cayman Islands dollars, the Aruban florin and the Caribbean guilder); the yen and the won. Paid in another currency on a trip? Choose it on the entry: the amount is kept as paid and converted at that day's European Central Bank rate (a currency fixed by law to one the ECB publishes, such as the CFP franc to the euro, at its fixed rate over that one's; another the ECB doesn't publish, at that day's rate from currency-api, from March 2, 2024).
• Average prices on the Dash (fuel and home electricity) come from the U.S. Energy Information Administration, so they're for the United States, in US dollars. In Canada, counting in Canadian dollars, the fuel price is Statistics Canada's monthly average (table 18-10-0001-01) for your province: the average of its survey cities, or Canada's for Nunavut, which has none. Regular, premium and diesel; Statistics Canada has no midgrade. In Europe and Oceania, counting in your country's own currency, it's the country's official average: the European Commission's Weekly Oil Bulletin in the EU's 27 member states (95 petrol and diesel, in euros or the national currency), the UK government's weekly road fuel prices (in pounds), Statistics Norway's monthly figure (in kroner), New Zealand's MBIE weekly average (91 and diesel) and, in Australia, Western Australia's FuelWatch (Perth's metro stations, for a region in Western Australia; no other state publishes a free average the app can use). Elsewhere there's no average price card. All of them are built into the app and arrive with its updates.
• Each log's CSV file (fuel, charging, mileage, maintenance, expenses, gig pay, business mileage) is written in your own units (Settings → Region → Units), whatever Home and away shows, with the unit in every column's name, and a fuel log imports back in whatever units it was written in. The backup (Export everything) keeps what's stored, miles and US gallons, so it restores the same whatever the units.

Plans and subscriptions

What's in each level?

There's no limit on how many fill-ups or charges you log, in any level, and no ads in any level.

What does it cost?

US prices. The App Store and Google Play set the price in your country, and the app shows it before you buy. Plus and Pro subscriptions start with a one-month free trial if you haven't had one before. Lifetime is Pro only and includes future Plus and Pro features. Automatic mileage tracking (Android) is a plan of its own, Pro + Automatic tracking: $56.99 a year with everything in Pro and a one-month free trial. It isn't part of lifetime; a Pro lifetime owner adds it for $42.99 a year.

How do I restore my purchase on a new phone?

Install MileWorks with the same Apple ID or Google account you bought it with, then Settings → Data → Your plan → See the plans → Restore purchases. Purchases stay with the store they were made in: one made on an iPhone doesn't carry over to Android, or the other way round.

How do I cancel?

Subscriptions renew automatically until you cancel, and they're managed by the store, not by MileWorks:

• iPhone: Settings → your name → Subscriptions → MileWorks → Cancel Subscription.
• Android: Google Play → your profile picture → Payments & subscriptions → Subscriptions → MileWorks → Cancel subscription.

Cancel at least 24 hours before the renewal date to avoid the next charge; you keep the level until the end of the period you paid for. Deleting the app doesn't cancel a subscription.

Bought lifetime while subscribed? Cancel the subscription yourself as above: the stores don't cancel it for you.

What happens to my data if a subscription ends?

Nothing is deleted, and you can still export all of it as CSV. Adding new maintenance, expenses or trips, Compare and the PDF reports need the level again. Three more things change on Lite:

• More than two vehicles: you pick the two to keep in use. The others are parked: greyed out in the Garage, with everything logged for them kept. You can export or delete a parked vehicle any time, or open its documents, receipts and photos, and change your pick within a day of choosing, then once every 30 days. Subscribing again brings them all back as they were.
• Repeating payments (insurance, a loan) pause: nothing is added on Lite. When you subscribe again, the Dash asks whether to add the payments that came due meanwhile or skip them.
• Home and away and the automatic region stay saved and stop applying: your own units show, at the region you set, until you subscribe again.

The automatic backup, if you turned it on, keeps running every day, parked vehicles included. Turned off, it needs MileWorks Plus to turn on again.

Refunds

Refunds are handled by the store. iPhone: reportaproblem.apple.com. Android: within 48 hours of buying, through Google Play; after that, email us at [email protected].

Permissions

MileWorks asks only when you use the feature that needs it, and works without any of them:

• Location (only while using the app, never "Always"): finds the gas station and address for an entry (when you tap Use my current location, or add a photo to a new fill-up that has no station yet), the place of an odometer reading, trip, maintenance visit, expense, rental pickup or purchase when you add one (Use where I am, or a new one's photo: where it was taken), and on Android the street address of a spot you type, pin or take from a photo (Android's address lookup needs it), places stops on the Passbook map, and measures the trips you record (MileWorks Pro). While a trip records, from Start until you tap Stop, the app keeps using location in the background or with the screen off: Android shows a "Recording a trip" notification the whole time, and iPhone its location indicator. The track stays on your phone.
• Location "All the time" and physical activity (Android, automatic tracking, MileWorks Pro + Automatic tracking): asked only when you turn on Settings → Trips → Automatic tracking, after the app says what it collects. They let it notice your drives and record them with the app closed; only each drive's start and end (and a crossing's spots) go to your phone's address lookup. Without automatic tracking, location stays "While using the app" only.
• Camera and photos: scanning or photographing the pump's screen, the odometer, receipts and invoices, and your VIN's barcode. Reading them happens on your phone, and the camera never uses the microphone. On Android the app also asks to read where a library photo was taken, so the station and address can come from it.
• Notifications: the reminders you turn on in Settings → Alerts (the weekly summary and the welcome messages among them), and on Android the "Recording a trip" notification while a trip records. They're made on your phone from your own log; nothing is sent.

Troubleshooting

• The numbers weren't read from my photo, or the scanner won't take it. Fill the frame with the numbers and hold the phone square to them. On a pump's or a dash's screen, glare is the usual trouble: tilt the phone a little. In the dark, turn on the light (top right of the scanner). If it still won't settle, tap the round button to take it: you see what it read before anything goes in. Scanning and reading photos need the app from the App Store or Google Play. With app version 1.0.5, the first time, an Android phone may still be getting its text reader from Google Play (the app says so): try again in a minute; if it still hasn't after a few minutes, the phone may not have Google Play services (the app says that too): type the numbers in. Later versions carry the reader. What doesn't add up isn't used: a pump's price that doesn't make its sale is left out (it's worked out from the amount and the total), and an odometer below your last reading (the trip meter?) isn't taken.
• No station was found. Station names come from OpenStreetMap, which doesn't know every station. Pick it from the list or type it in.
• The Passbook's map won't drag, or shows no streets. The map you can drag and zoom (tap the Passbook's map, or Open the map) needs app version 1.0.7 or later, and a connection for its streets, which come from OpenFreeMap (OpenStreetMap's map); once it has loaded, the streets already seen stay on the phone. Where you are appears only when MileWorks may already use your location. The overview and its list of stops work everywhere, offline too.
• The app asks about an odometer reading. A reading far past the last one, or lower than an earlier one, gets a question before it's saved. Fix the typo, or say it's right.
• The app asks about a price. A price far from what you usually pay for that fuel or kind of charging (a decimal point left out turns 3.899 into 3,899), or a charging session over 250 kWh, gets a question before it's saved. Fix it, or save it as it is.
• Something else? Most screens are explained in Help (the ? at the top right).

Contact us

Email [email protected] with your phone model and the app version (Settings → Data → About). Please don't send your backup file unless we ask: it holds your whole log.

MileWorks LLC · 1209 Mountain Road Pl Ne, Ste N, Albuquerque, NM 87110