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

# Engagement types and on-costs

> Record how each contractor is engaged and model the employer costs on top of their pay, so you see the real margin on every contract placement.

An **engagement type** describes how a contractor on a contract placement is employed and
paid, for example a **W-2 employee** in the United States or a **Ltd company (inside IR35)**
in the United Kingdom. **On-costs** are the employer costs that come on top of the pay rate,
such as payroll taxes, social security, insurance and holiday pay. Which on-costs apply
depends on the country and the engagement type.

With engagement types and on-costs you can:

* **Record the engagement type** on every contract placement, and filter your placements on it.
* **Model on-costs** from defaults you set per country and engagement type, and adjust them
  for a single placement.
* **See your margin before and after on-costs**, so you know what a placement really earns.
* **Keep the rate you agreed with the client**: on-costs come out of your margin instead of
  changing the client's price.

![The Fee Details step of a contract placement with an engagement type and on-costs modelled](https://mintcdn.com/spott-docs/ZO3ahY9BdODH9imX/images/placements/engagement-fee-details.webp?fit=max\&auto=format\&n=ZO3ahY9BdODH9imX\&q=85\&s=722db638b6aae24369f04359924a57b1)

## Countries and engagement types

Spott comes with engagement types for four countries:

| Country | Engagement types |
| - | - |
| **United States** | W-2 employee, 1099 contractor, Corp-to-corp |
| **United Kingdom** | PAYE employee, Umbrella company, Ltd company (outside IR35), Ltd company (inside IR35) |
| **Australia** | PAYG casual, PAYG fixed term, ABN Contractor, Pty Ltd contractor |
| **Belgium** | Temporary agency worker, Student, Flexi-job, Self-employed (sole trader), Self-employed (via company), Secondment |

Every engagement type has its own default on-cost lines, which you can change in
[Settings](https://docs.spott.io/docs/settings/default-on-costs.md). Engagement types where the contractor isn't on
your payroll, such as **Umbrella company** or **Ltd company (outside IR35)**, start without
on-cost lines, because the umbrella company or the contractor's own company carries those
costs.

## Add the engagement type to a placement

Engagement types are part of [contract placements](https://docs.spott.io/docs/placements/placements.md#contract-placements).
Make sure the job's **Fee Structure** is set to **Contract**.

![A job whose Fee Structure is set to Contract](https://mintcdn.com/spott-docs/ZO3ahY9BdODH9imX/images/placements/job-fee-structure-contract.webp?fit=max\&auto=format\&n=ZO3ahY9BdODH9imX\&q=85\&s=a437db26946f2cdf434a5136541aed97)

1. Open the candidate's application on the job and click **Mark placed**.
2. In the **Fee Details** step, fill in the dates, working schedule and unit as usual.
3. Under **Engagement**, choose the **Country**.
4. Choose the **Engagement type**. The list shows the engagement types for that country,
   each with a short description.

![Choosing the country under Engagement](https://mintcdn.com/spott-docs/ZO3ahY9BdODH9imX/images/placements/engagement-country.webp?fit=max\&auto=format\&n=ZO3ahY9BdODH9imX\&q=85\&s=739f717a3cabe1125bb2afcba20fae7b)

Add the engagement type even if you don't model on-costs. It is saved on the placement, so
you can [filter your placements](#filter-placements-by-engagement-type) on it later.

![Choosing the engagement type, each with a short description](https://mintcdn.com/spott-docs/ZO3ahY9BdODH9imX/images/placements/engagement-type.webp?fit=max\&auto=format\&n=ZO3ahY9BdODH9imX\&q=85\&s=b903b35f319bba9b0a41cba7b7eef46a)

## Model on-costs

To model on-costs, the placement needs an engagement type.

1. In the **Fee Details** step, turn on **Model on-costs**. Spott adds an **Oncosts** step
   to the placement, prefilled with the default on-cost lines of the engagement type.
2. Under **Rates**, enter the **Pay rate (contractor)** and the **Charge rate (client)**.
   Spott works out the **Markup on pay** and the **Margin**.
3. Click **Next** to check the on-cost lines in the **Oncosts** step.

With **Model on-costs** turned off, the margin is the charge rate minus the pay rate. With it
turned on, the on-costs are subtracted as well:

* **Markup on pay** is the difference between charge rate and pay rate, as a percentage of
  the pay rate. It doesn't include on-costs.
* **Margin** is what you keep after the pay rate and the on-costs, as a percentage of the
  charge rate.

The **Billing projection** shows the **Total contract value**, the **Margin** per day and
the **Total net fee (margin)** for the whole placement.

### Adjust on-costs for one placement

The **Oncosts** step lists each on-cost line as a percentage of the pay rate, with the
amount it adds per day. Changes here only apply to this placement:

* To change a percentage, type the new value in its field.
* To remove a line, click the bin icon next to it.
* To add a line, click **+ Add oncost**.
* To undo your changes, click **Reset to defaults**. This brings back the defaults from
  Settings.

Below the lines, Spott shows the **Margin before on-costs**, the **Oncosts**, the **Margin
after on-costs** and the **Projected GP** for the whole placement.

To change the defaults for new placements, see [Default on-costs](https://docs.spott.io/docs/settings/default-on-costs.md).

### Example

A W-2 employee in the United States is paid 700 a day and charged to the client at 1,000 a
day, for 10 days. The on-costs add up to 13.95% of pay.

| | Per day | Whole placement |
| - | - | - |
| Charge rate | 1,000.00 | 10,000.00 (Total contract value) |
| Pay rate | 700.00 | |
| Margin before on-costs | 300.00 | |
| Oncosts (13.95% of 700) | 97.65 | |
| Margin after on-costs | 202.35 (20.23%) | 2,023.50 (Projected GP) |

The markup on pay is 42.86%. Because on-costs are calculated on the pay rate, changing the
charge rate doesn't change them: it only changes your margin.

### Keep the rate you agreed with the client

The charge rate, the markup and the margin depend on each other. The **charge rate** is
pinned, shown by the pin icon in its field, so it stays fixed when the other numbers change.

With the charge rate pinned, adding or raising on-costs lowers your margin. It never raises
the client's price. The **Oncosts** step reminds you of this with a banner, for example
**Charge rate pinned: editing on-costs moves the margin (now 20.23%)**.

## Save the placement

Fill in the **Splits** and **Extra** steps as usual, then click **Save Placement**.

The placement shows on the application with its **Rates** (charge, pay and on-cost amount),
the **Oncosts** percentage and the **Margin**.

![A saved contract placement on the application with its Rates, Oncosts and Margin](https://mintcdn.com/spott-docs/ZO3ahY9BdODH9imX/images/placements/placement-on-application-oncosts.webp?fit=max\&auto=format\&n=ZO3ahY9BdODH9imX\&q=85\&s=f8be1ac47e695710bd78fdd11d361c74)

## Filter placements by engagement type

1. Go to **Placements** and open the **Contract** tab.
2. Click **Engagement type**, next to **Weekly** and **Monthly**, and select one or more
   engagement types.

![The Engagement type filter on the Contract tab of Placements](https://mintcdn.com/spott-docs/ZO3ahY9BdODH9imX/images/placements/placements-engagement-filter.webp?fit=max\&auto=format\&n=ZO3ahY9BdODH9imX\&q=85\&s=5eb90e0c3c00bff81ceb894b2544d7df)

The statistics, the forecasts and the list of placements now only include placements with
those engagement types. Click **Clear all** to remove the filter.

![The Contract tab of Placements filtered on W-2 employee](https://mintcdn.com/spott-docs/ZO3ahY9BdODH9imX/images/placements/placements-engagement-filtered.webp?fit=max\&auto=format\&n=ZO3ahY9BdODH9imX\&q=85\&s=340810f90c63bf39dd96b25c9173e38f)

## Limitations

* Engagement types and on-costs are available for the **United States**, the **United
  Kingdom**, **Australia** and **Belgium**.
* On-costs are a **percentage of the pay rate**. Fixed amounts per hour or day aren't
  supported.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.