> ## Documentation Index
> Fetch the complete documentation index at: https://help.owlery.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Fuel Surcharges

> Create fuel surcharge schedules and pair them with contract rates so surcharges apply automatically.

**Where to find it:** `Dashboard → Fuel Charges`

The **Fuel Charges** page is where you manage fuel surcharge schedules. These can be linked to contract rates so surcharges are automatically applied based on the current fuel price.

### The Fuel Charges Table

| Column         | What it shows                                      |
| -------------- | -------------------------------------------------- |
| **Name**       | A note or label for the schedule.                  |
| **Type**       | **Percentage** or **Per-Mile**.                    |
| **Currency**   | USD, CAD, or MXN.                                  |
| **Rate Tiers** | How many price → surcharge tiers the schedule has. |

Click a row to open a detail drawer showing the full tier table:

* **Fuel Price Range** — The fuel price band (e.g., \$2.000 – \$2.499).
* **Fuel Surcharge Rate** (percentage) or **Rate Per Mile** (per-mile) — The surcharge that applies when fuel is in that range.

### Creating a Fuel Schedule

Fuel schedules are created by CSV upload:

<Steps>
  <Step title="Download a template">
    Click the **Upload CSV** button, then pick your template from the dropdown:

    * **Download Percentage Template** — Columns: `Fuel Price From`, `Fuel Price To`, `Surcharge Rate`
    * **Download Per-Mile Template** — Columns: `Fuel Price From`, `Fuel Price To`, `Rate Per Mile`
  </Step>

  <Step title="Fill in your tiers">
    The **last tier** should have an empty `Fuel Price To` to mean "and above." Fuel prices use 3 decimal places (mills precision).
  </Step>

  <Step title="Upload and confirm">
    Click **Upload CSV** again and select your file. The system validates and shows a preview. Confirm to create.
  </Step>
</Steps>

### Pairing a Fuel Schedule with a Contract Rate

Once paired, the schedule appears in the contract rate's detail drawer → *Fuel Schedule* tab, and the *All In* column on the main table changes from "All In" to "Fuel Schedule."\
\
Once paired, the schedule appears in the contract rate's detail drawer → *Fuel Schedule* tab, and the *All In* column on the main table changes from "All In" to "Fuel Schedule."\\

<Steps>
  <Step title="Open a contract rate">
    Create a new rate or edit an existing one.
  </Step>

  <Step title="Select the schedule">
    In the **Fuel Charge Table** dropdown, select the schedule you want. The dropdown shows each schedule as `name - type - N tiers`.
  </Step>

  <Step title="Save">
    Once paired, the schedule appears in the contract rate's detail drawer → **Fuel Schedule** tab, and the **All In** column on the main table changes from "All In" to "Fuel Schedule."
  </Step>
</Steps>

### Tips

* No fuel schedule = "All In" rate (fuel included in base price).
* If using a per-mile schedule, fill in the **Total Distance** field on the contract rate so the system can calculate the surcharge.
* The same fuel schedule can be reused across multiple contract rates.
* Use **Download Template** on the contracts page to export all your existing rates with their linked fuel schedules for bulk review.