> ## 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.

# Team and permissions

> Invite your team, choose what each role can see and do, and see who changed what.

Everyone on your farm signs in as themselves and works within a role. The role decides which screens they see, what they can change, whether they ever see a dollar figure, and whether they sign in on the web, the phone app, or both.

Settings › Team

## Members

Settings › Team › Members

The members list has **Active** and **Removed** tabs, with **Add Member** at the top. Each person's **Manage** menu offers **Change role**, **Suspend** or **Unsuspend**, and **Remove**. Members who are also [sales reps](https://docs.terracetech.co/guides/sales-reps.md) carry a **Sales rep** tag. Invitations that haven't been accepted yet wait in a **Pending invitations** card.

> [!NOTE]
>
> Managing members needs **Invite, change and remove members**. That permission covers everyone except admins and owners. Only an owner can add, change or remove an admin.

### Invite someone

**1. Add the member**

Press **Add Member**. In **Add team member**, enter their first name, last name and email, then choose a **Role**. There's no default role, and you can only give roles you're allowed to give.

**2. Send the invitation**

Press **Send invitation**. Terrace emails them a link. If the email can't be sent, the dialog shows the link so you can copy it and send it yourself.

**3. They accept**

The link works only for that email address, and expires after seven days. Cancel an invitation that's still waiting with **Cancel Invitation**.

### What the person you invite sees

The invitation page shows **Team invitation**, your farm's name, and **You'll join as** their role.

* **New to Terrace?** They see **Set up your account**: first and last name, email, username, password, and confirm password. Passwords need **at least 8 characters** and **no spaces, emojis, or unicode**. Then **Create account**.
* **Already have a Terrace sign-in?** They see **Sign in to accept**.
* Either way, they then **verify their email**. They open the email from Terrace, press **I've verified my email** (or **Resend the email**), and then **Accept the invitation**.

> [!TIP]
>
> A verified email is required to join a farm. If someone is stuck on the invitation, have them check spam for the verification email and use **Resend the email**.

### Suspend or remove a member

* **Suspend** stops someone from signing in without removing them. **Unsuspend** lets them back in.
* **Remove** takes them off the farm. The **Remove team member** dialog walks through three steps:
  1. **Impact**: what's still assigned to them.
  2. **Reassign**: hand their work to someone else, or **Unassign all**.
  3. **Confirm**, with an optional **Reason**.

Removed members move to the **Removed** tab, where you can reactivate them.

### More than one farm

One person can belong to several farms with the same sign-in. If you're on more than one, a **Farm** switcher appears at the foot of the sidebar when it's expanded. Choose a farm to switch to it. Your role can be different on each farm.

## Roles

Settings › Team › Roles & permissions

Terrace comes with preset roles. Start from one and adjust it, or create your own. **Owner** is locked.

| Role | What it's for |
| - | - |
| **Owner** | Everything, including ownership, billing and managing admins. |
| **Admin** | Everything except the owner-only actions. Manages every member except admins and owners. |
| **Operations** | The office. Orders, customers, projects, sales reps, invoices and payments, bookings, product prices, delivery planning, reports and integrations. Sees financial information. No team management, roles or farm settings. |
| **Farm Staff** | The field. Orders without money, project tasks, inventory, harvest, operations, the calendar and delivery planning. Never sees financial information. |
| **Driver** | Their own assigned deliveries, on the mobile app. |
| **External driver** | Only the deliveries assigned to them, on the mobile app. For brokered and outside truckers. They see a delivery contact's name and phone only while the delivery is active. |

> [!NOTE]
>
> **Coming from an earlier version?** Your team kept their access. **Staff** is now **Operations**, **Farm staff** is now **Farm Staff**, and **Trucking** is now **Driver**. The six separate money switches from before are now one: **See financial information**.

### Two settings on every role

* **Can sign in on**: **Web**, **Mobile app**, or both. Drivers are set to the mobile app. Someone whose role is mobile-only who signs in on the web sees **Use the Terrace mobile app**.
* **People on this role are**: **Internal staff** or **External partner**. External partners, such as outside truckers, see only what's assigned to them.

## Financial information

**See financial information** is the single switch for money. With it on, the role sees prices, totals, revenue and balances everywhere. With it off, there is **no dollar figure anywhere, on any screen, export, printout or Scout answer**.

Several permissions need it, and drop off automatically if it's off: creating and editing orders, setting product prices, customer discounts, everything under invoices and payments, analytics money, and the activity log.

> [!TIP]
>
> This is what lets a field crew work orders, harvest and the calendar without ever seeing what a customer pays.

## Permissions

Each role is a set of permissions, grouped by area. A permission marked with an asterisk (\*) needs **See financial information**.

> [accordion] Dashboard, orders and customers
>
> **Dashboard**
>
> * View the dashboard
>
> **Orders**
>
> * View orders
> * Create orders\*
> * Edit orders\*
> * Change order status
> * Record harvest progress
> * Delete orders
> * Export orders
>
> **Customers**
>
> * View customers
> * Create customers
> * Edit customers
> * Delete customers
> * Manage customer discounts\*
> * Export customers
>
> **Bookings**
>
> * View bookings
> * Manage bookings

> [accordion] Projects and sales reps
>
> **Projects**
>
> * View projects and tick off their own tasks
> * Create and edit projects and assign tasks
>
> **Sales reps**
>
> * View sales reps and every rep's customers and orders
> * Add and edit sales reps
> * View their own sales, as a linked sales rep

> [accordion] Inventory and operations
>
> **Inventory**
>
> * View products, crops and locations
> * Create and edit products, crops and locations
> * Set product prices\*
> * Adjust stock
> * Delete products, crops and locations
> * Export inventory
>
> **Operations**
>
> * View operations, harvest and the calendar
> * Log and schedule operations
> * Add, edit and retire equipment

> [accordion] Deliveries
>
> * View all deliveries and loads
> * Plan loads and assign drivers
> * View and complete deliveries assigned to them

> [accordion] Money: financial information, invoices, analytics
>
> **Financial information**
>
> * See financial information (prices, totals, revenue, balances)
> * Export financial data
>
> **Invoices and payments** (all need financial information)
>
> * View invoices
> * Create invoices
> * Edit invoices
> * Void and delete invoices
> * Export invoices
> * Take and record payments
>
> **Analytics**
>
> * View analytics. Money shows only with financial information.

> [accordion] Scout, team and farm settings
>
> **Scout**
>
> * Use Scout
>
> **Team and roles**
>
> * View team members
> * Invite, change and remove members (not admins)
> * Create and edit roles
> * View the activity log\*
>
> **Farm settings**
>
> * Manage farm settings
> * Manage integrations (QuickBooks, Square, Clover)
>
> **Ownership** (owner only)
>
> * Add, change and remove admins

## Edit or create a role

Open a role from the roles list. Each row reads like **Custom role · External partners · 3 members · Web and mobile app**, and Owner shows a lock.

The role editor has:

* **Details**: **Name**, **Can sign in on**, and **Description**, with tags for the member count and **Internal staff** or **External partners**.
* **Permissions**, by area as listed above, with **Reset to** the preset it came from.
* **Save**, and **Delete** for roles you created.

To make a new role, press **Create role**. Give it a name and description, choose **Start from** (blank or a preset), set **Can sign in on**, and choose whether **People on this role are** **Internal staff** or **External partner**.

> [!WARNING]
>
> You can't give a role anything you don't have yourself, and only owners can grant the team management powers. If a permission is greyed out, ask someone with more access.

## Activity log

Settings › Team › Activity log

The activity log is the farm's record of what changed, when, and by whom. When a number looks wrong or a record went missing, start here.

* **Search events** finds a record or a change.
* **When**: **Last 7 days**, **Last 30 days** (the default), **Last 90 days** or **All time**.
* **Type**: **All types**, or one of Orders, Invoices, Customers, Projects, Loads, Crops, Products, Locations, Operations, Scheduled operations, Materials, Equipment, Integrations, Calendar or Farm.
* **Status**: **All statuses**, **Info**, **Warning**, **Error** or **Critical**.
* **Clear filters** resets them. The log shows 25 events per page.
* On the web, **Export** offers **Export as Excel** or **Export as PDF**.

> [!NOTE]
>
> The activity log needs **View the activity log**, which also requires **See financial information**.

## Related

> [card] [Settings](https://docs.terracetech.co/guides/settings.md)
>
> Every settings tab and section.

> [card] [Sales reps](https://docs.terracetech.co/guides/sales-reps.md)
>
> Link a member to a sales rep so they see their own sales.

> [card] [Drivers](https://docs.terracetech.co/guides/drivers.md)
>
> What drivers and external drivers see on the phone.

> [card] [Troubleshooting](https://docs.terracetech.co/guides/troubleshooting.md)
>
> When someone can't find a feature or can't sign in.


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