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

# Sales reps

> Track which reps bring in which customers, orders and projects, and see each rep's sales.

Sales reps let you credit orders to the people who sell them. Set a default rep on a customer, and their orders carry that rep automatically. Each rep gets a page with their customers, orders, projects and invoices.

Settings › Team › Sales reps

> [!NOTE]
>
> Sales reps are new in Terrace 2.0. They live in Settings, under **Team**, not in the sidebar.

## The sales reps list

Open **Settings**, choose the **Team** tab, then **Sales reps**. Across the top you see:

| Figure | What it shows |
| - | - |
| **Active Reps** | Reps currently marked Active. |
| **Orders** | Orders credited to reps in the chosen range. |
| **Sales** | What those orders total. Financial access only. |
| **Open Balance** | What reps' customers still owe. Financial access only. |

Switch between **Active** and **Inactive** reps, search with **Search sales reps...**, and choose a range in **Orders from**: **This Month**, **Last Month**, **This Quarter**, **This Year** (the default), **Last Year**, **Last 12 Months** or **All Time**.

The table shows each **Sales Rep**, who they **Signs In As**, and their **Customers**, **Orders**, **Sales** and **Open Balance**. Row actions are **View**, **View orders** and **Edit**.

## Add a sales rep

**1. Open the panel**

Press **Add Sales Rep**.

**2. Fill in the details**

Enter the rep's **Name**, **Email** and **Phone**.

**3. Link a login, if they have one**

Under **Signs in as**, pick the team member this rep is, or choose **Does not sign in** for an outside rep. A rep linked to a member shows a **Sales rep** tag in your members list.

**4. Set the status**

Leave the **Status** as **Active**, then save.

### Retire a rep

You can't delete a sales rep. When someone stops selling for you, edit them and set the **Status** to **Inactive**. Their history stays on every order and report, and they drop off the pickers for new work.

## A rep's page

Open a rep to see their book of business. The band shows their **Orders**, **Customers** and **Projects**, plus **Sales**, **Open Balance** and **Invoiced** with financial access.

* **View in Orders** opens the [orders list](https://docs.terracetech.co/guides/orders.md) filtered to that rep.
* **Edit Sales Rep** changes their details or status.
* Tabs list the rep's **Customers**, **Orders**, **Projects** and **Invoices**.

## Where reps are set

| Where | How |
| - | - |
| **Customer profile** | Set a **Default Sales Rep** on the details card. New orders for that customer start with this rep. |
| **Order** | Add reps with **Add rep** in the top bar of the order form's **Review & Submit** step, or in the order's summary later. An order can have several reps, up to 10. |
| **Project** | Pick one **Sales Rep** on the project. Orders on the project start with the project's rep, ahead of the customer's default. |
| **Phone** | The order form on the phone has a **Sales reps** sheet. |

On the order form, the rep chips say where a rep came from: **Customer's default** or **Project's rep**. The rep picker only shows on farms that keep sales reps.

The orders list has a **Sales Rep** column (off by default) and a **Sales Rep** filter.

> [!NOTE]
>
> Each rep on an order gets credit for the whole order. Terrace doesn't split credit between reps, and it doesn't calculate commissions.

## Who can see what

Three permissions shape access to sales reps:

| Permission | What it allows |
| - | - |
| **View sales reps and every rep's customers and orders** | See the list and every rep's page. |
| **Add and edit sales reps** | Add reps, edit them and set them inactive. |
| **View their own sales, as a linked sales rep** | A rep who signs in sees their own page and sales only. |

> [!NOTE]
>
> Owner, Admin and Operations can view and manage reps by default. Sales, balances and invoiced figures only show to people with **See financial information**. Changing the reps on an existing order needs **Edit orders**.

## Related

> [card] [Orders](https://docs.terracetech.co/guides/orders.md)
>
> Add reps on the order form and filter the list by rep.

> [card] [Customers](https://docs.terracetech.co/guides/customers.md)
>
> Set a default rep for each customer.

> [card] [Team and roles](https://docs.terracetech.co/guides/team.md)
>
> Give a rep their own login and the right permissions.

> [card] [Settings](https://docs.terracetech.co/guides/settings.md)
>
> Everything else under Settings.


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