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

# Crops and harvest

> Track each crop from seeding to ready, see what's coming on a timeline, then harvest or pick it for orders.

A crop is one planting moving through its growing life: a block of liners, a field of sod, a bench of flats. Crops tell you what's coming, what's ready, and which planting each order was filled from.

Inventory › Crops

> [!NOTE]
>
> **Harvest or pick?** Nursery, tree and greenhouse farms see **Pick**, **Picked** and **Pick List**. Sod farms see **Harvest**, **Harvested** and **Harvest List**, and count crops by **Area** instead of plants. It's the same feature with your crew's wording.

> [!NOTE]
>
> Crops were called **batches** in Terrace 1.x. Only the name changed: every batch you had is now a crop, with the same quantities, locations and history.

## The Crops page

InventoryCrops

**Growing**Crops seeding or growing**Ready to Pick**Ready to fill orders (Ready to Harvest on sod farms)**Ready in 30 Days**Growing crops due ready within 30 days

**New Crop** on the band starts a new planting. Crops carry no price, so the page shows no money.

Under the toolbar, stage tabs split the list, each with its count: **All** (everything not archived), **Seeding**, **Growing**, **Ready**, **Picked** (**Harvested** on sod farms) and **Archived**.

### The toolbar

* **Search crops** finds crops by name, SKU or product.
* **Filters** narrows the list by **Product** and **Location** (a location or one of its subunits). The stage is set by the tabs, so **Clear All** leaves the tab you're on. While a filter is on you'll see "Showing 6 of 18 crops" with a chip for each filter.
* **Group by** puts rows under a heading per **Location** (the default) or **Product**, or **None**.
* The **List**, **Timeline** and **Cards** switch changes the view.
* The gear opens **Display Settings**.

### List view

The list keeps to the essentials. By default each row shows the **Crop**, its **Location**, **Plants** (**Area** on sod farms), when it's **Ready**, and its **Status**. The ready date counts down: **Today**, **Tomorrow**, a number of days away, or days overdue once a growing crop is past it.

More columns are a switch away in **Display Settings**:

| Group | Setting | What it does |
| - | - | - |
| **Appearance** | **Row Size** | **Comfortable** or **Compact** rows. |
| **Appearance** | **Crop Tiles** | **Show** or **Hide** the tile beside each crop's name. |
| **Visible Columns** | Column list | Turn on **SKU**, **Planted**, **Growing Phase**, **Growth**, **On Orders** and **Health**, turn off any column except **Crop**, and drag them into the order you like. |

Your choices are saved for you, not for the whole farm. Each row ends with a menu: **Edit Crop**, **Size Up**, **Pick** (or **Harvest**), **Archive** and **Delete**, depending on the crop's stage and your permissions.

### Timeline view

The timeline draws each crop as a bar from when it was planted to its ready date, grouped the same way as the list. It's the quickest way to see what's coming ready over the next few months.

* Each bar is split into the stages the crop went through, colored like its status: **Seeding**, **Growing**, **Ready** and **Picked** (**Harvested**).
* The part still ahead shows as **Still to grow**. A crop past its expected ready date shows **Late** in red.
* Hover a stretch of the bar to see the stage and its dates.
* The timeline opens with today about a third of the way across. **Today** brings you back there, and the arrows move three months at a time. Scroll sideways to reach earlier or later months.

The timeline is on the web. Its **Display Settings** has **Row Size** only.

### Cards view

Cards show each crop as a card, without grouping. It's the view a narrow browser window uses.

## Stages

| Stage | What it means |
| - | - |
| Seeding | Planted, not yet growing. |
| Growing | Maturing in the field, greenhouse or yard. |
| Ready | Grown out and ready to sell. |
| Harvested | Pulled for orders (**Picked** on picking farms). |
| Archived | Closed out. |

Which stages count as stock you can sell is your choice. Set it with **Count as on hand** in the Products page's [Display Settings](https://docs.terracetech.co/guides/inventory.md).

### Health and growing phase

Each crop carries a health rating, set with **Update Health**, a logged health check operation, or **Edit Crop**:

Excellent Good Fair Poor Failed

Crops also record a growing phase, and the phases follow your farm type. A nursery, for example, sees **Propagation**, **Vegetative**, **Hardening Off** and **Flowering / Fruiting**.

## Create a crop

**1. Start a crop**

Press **New Crop** on the band, or **New Crop** in the **Crops** section of a product's side panel.

**2. Crop information**

Choose the product and size, enter the **Crop Name** and, if you use them, a **SKU / Lot #**.

**3. Location**

Choose the location with **Assign to Location**, and an **Active Subunit** if the location is split into zones, benches or tables.

**4. Quantity and stage**

Enter the quantity, the **Status** (**Seeding**, **Growing** or **Ready**), the **Growing Phase** and, optionally, the **Health Status**.

**5. Timeline**

Enter the **Planted Date** and an optional **Ready Date**. The ready date drives the countdown, the **Ready in 30 Days** count and the timeline.

> [!TIP]
>
> On a product, the tracking choice that uses crops is called **Tracked by Crop** (it was **Batch Tracking**). See [Inventory](https://docs.terracetech.co/guides/inventory.md).

## The crop panel

Click a crop to open its panel on the right. It's kept short on purpose. The top shows the crop's name, size and location, with three numbers: **Plants**, **On Orders** and **Ready**. If a growing crop is past its ready date, a notice says so.

Below that:

* **Details**: **Status**, **Location**, **Growing Phase**, **Planted**, **Ready Date** and **Started With**. A crop that is still growing also offers **Mark Ready**.
* The orders holding the crop.
* **Activity**, the newest changes, with **View History** for the rest.
* **Notes**.

The footer holds the actions, the main one last:

| Action | What it does |
| - | - |
| **Pick** / **Harvest** | Records what you pulled. Enter the **Actual Yield** and a **Quality Grade** (**A**, **B** or **C**), and Terrace shows the yield and waste. |
| **Size Up** | Moves plants into a bigger size as a new crop. |
| **Edit Crop** | Changes the crop's details. |
| More actions | **Update Health**, **Archive** and **Delete**. |

The same panel opens from the [Calendar](https://docs.terracetech.co/guides/calendar.md) when you click a crop there.

> [!NOTE]
>
> **Edit Crop**, **Size Up** and **Harvest** need **Create and edit products, crops and locations**. Archiving a crop and changing its health or phase are also allowed with **Log and schedule operations**, so crews logging field work can keep crops current. **Delete** needs **Delete products, crops and locations**.

## Pull a crop for an order

When an order line is tracked by crop, you can choose its source while you take the order: **Source Crop** on the order form and in Retail Checkout.

When an order is marked **Harvested**, or a product is ticked off in harvest progress, Terrace needs to know where the product came from. If more than one crop could supply it, a dialog opens: **Select Crop Source**, or **Select Field Source** on sod farms.

**1. Choose the source**

Pick the crop or field the product came from. If it didn't come from a tracked crop, choose **No crop source** (**No field source** on sod farms). That skips the inventory deduction for that product.

**2. Confirm**

Press **Confirm Harvest** or **Confirm Pick**. Terrace takes the quantity off that crop and links it to the order.

Picked the wrong one? Use **Change crop assignment** in the order's summary to move it.

Every order can tell you which planting it came from, and every crop can tell you which customers it went to.

### Track harvest per product

By default you mark a whole order harvested at once. If your crew pulls an order a product at a time, turn on per-product tracking:

Settings › Farm › Scheduling

In the **Harvest progress** card (**Picking progress** on picking farms), turn on **Track harvesting per product**. Orders then show a progress card where your crew ticks off each product with **+**/**−**, uses **Mark all**, saves, and presses **Mark order Harvested** when everything is pulled. On an order with several deliveries, progress is kept per delivery.

> [!NOTE]
>
> Ticking off products needs the **Record harvest progress** permission. The Owner, Admin and Farm Staff presets have it.

## The harvest or pick list

The **Harvest List** (or **Pick List**) is a printable sheet your crew takes into the field. Open an order, choose **Share**, and pick the list. You can print it in **English** or **Español**, or save it as a PDF. On the phone app it's on the order as **Harvest list**, with locations and check-offs.

## Plan the day's picking

To see what has to be pulled and when, use the [Calendar](https://docs.terracetech.co/guides/calendar.md):

* Turn on the **Harvest** layer to see orders by fulfillment date.
* In the **Day** view, press **Pick Breakdown** (**Harvest Breakdown** on sod farms). It shows the **Day Total**, then splits it into **Morning**, **Afternoon** and **Evening**.
* Turn on the **Crops** layer to see crops coming ready.

How times appear is set in Settings › Farm › Scheduling under **Fulfillment times**: **Specific times** or **Time frames**.

For the longer view of what's coming ready, use the Crops page's **Timeline**.

## On the phone

The phone app's **Inventory** tab includes **Crops**, so you can look up a crop from the field. Harvest lists open from the order.

## Related

> [card] [Inventory](https://docs.terracetech.co/guides/inventory.md)
>
> Products, stock and what counts as on hand.

> [card] [Operations](https://docs.terracetech.co/guides/operations.md)
>
> Log health checks, spraying and fertilizing against a location's crops.

> [card] [Calendar](https://docs.terracetech.co/guides/calendar.md)
>
> Harvest dates, crops and the day's pick breakdown.

> [card] [Orders](https://docs.terracetech.co/guides/orders.md)
>
> How an order moves to Harvested.


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