CropWatch Knowledge Base
EN English

Crop targets and growing advice

Tell CropWatch which crop a soil sensor sits in, and the sensor's page judges its readings against that crop's growing targets: soil and air, day and night, and the day's light. Once a day it also writes a Growing advice card about the previous day. This guide covers choosing the crop, reading the targets and the status labels, the light targets, and what the advice card can and cannot tell you.

On this page

What choosing a crop changes

The Above & below ground panel of a soil sensor without a crop, showing soil temperature, soil moisture, EC and pH with no targets, and under it the notice “Choose this sensor's crop in the device settings to see its growing targets.” with a Choose a crop button

Without a crop, the readings have no targets and a notice offers to set one.

Without a crop, the readings have no targets and a notice offers to set one.

A soil sensor without a crop shows its readings and nothing more. Under the readings panel it carries a notice: “Choose this sensor's crop in the device settings to see its growing targets.”

Once the sensor has a crop, the same page adds:

  • A targets card: titled with the crop, for example “Targets for Tomato”, listing each reading, its target and a status.
  • Status chips and target ranges: on each reading in the “Above & below ground” panel at the top of the readings.
  • Target lines on the chart: green lines named after the crop, such as “Tomato min” and “Tomato max”, on the “Time series” chart.
  • Light and VPD targets: a band on the VPD chart, a target for the current hour on the PPFD gauge and a daily goal on the “DLI Today” card, on sensors that measure air and light.
  • The “Growing advice” card: a daily report on the previous day, with what to change.

Only soil sensors take a crop. Air, water and other sensors have no “Crop” box in their settings.

Choosing the crop

The Device Settings card of a soil sensor with the Crop list open: No crop, Tomato (ticked), Cherry tomato, Cucumber, Sweet pepper (paprika / bell pepper) and Poblano pepper, with more below

Pick the crop from the list, then press Update Device.

Pick the crop from the list, then press Update Device.
  1. Open the sensor's settings page. Press “Choose a crop” in the notice on the sensor's page (it is there while no crop is set), press “Settings” at the top of the sensor's page, or use the cog in the location's list of sensors. Opening the settings page explains the ways in.
  2. In the “Device Settings” card, find “Crop”, just below “Location”. The line under it reads “Sets the growing targets this soil sensor's readings are judged against.”
  3. Open the list and pick the crop, for example Tomato, Cucumber or Strawberry. Crop names follow the language you use CropWatch in.
  4. Press “Update Device”. The button stays grey until something on the card has changed.
  5. A bar reads “Device settings updated.” Press “Back To Device Detail”; the targets card is now on the sensor's page.

To take the crop off, choose “No crop” at the top of the list and press “Update Device”. The targets card, the target lines and the advice card leave the sensor's page. The readings themselves are not touched.

Changing to a different crop changes the targets card and the chart lines straight away, for past readings as well as new ones. The advice card catches up with the next overnight report.

If a soil sensor's settings page has no “Crop” box, the list of crops did not load. Reload the page. If the box is still missing, contact support.

Who can choose the crop and who sees the results

Choosing the crop counts as editing the sensor, so it needs the same level as renaming it: Owner, Admin or Manager. Everyone who can see the sensor sees its targets and its advice. Disabled people cannot see the sensor at all.

On the sensor's own page, the “Settings” button appears only at Admin level. A Manager reaches the settings page through the “Choose a crop” button, which shows while the sensor has no crop, or through the cog in the location's list of sensors. The levels are explained in Sharing access.

Crop targets and growing advice by permission level
TaskOwnerAdminManagerUserViewer
See the targets and the Growing advice card Yes Yes Yes Yes Yes
Choose, change or remove the crop Yes Yes Yes No No

Where the target numbers come from

CropWatch sets the targets; you only choose the crop. Each crop's values were gathered from published growing guidance and research, such as Japan's Ministry of Agriculture, Forestry and Fisheries, prefectural agricultural research centres, the FAO and university extension services, and each value is stored with the source it came from. Everyone who picks the same crop gets the same numbers, and there is no screen for changing them.

A crop can have targets for these readings:

  • Soil: soil temperature, soil moisture, soil EC and soil pH, each with one target for the whole day.
  • Air: air temperature and air humidity, each with a day target and a night target.
  • Daytime only: CO₂ and VPD.
  • Light: a daily light goal (DLI), and the light level above which more light adds little (light saturation).

Each target is a best range, and some also have stress limits: the levels past which the crop starts to suffer damage. Where the research gave no reliable number, the value is left blank rather than guessed.

  • Soil moisture assumes a loam soil. Soils that hold much more water, such as volcanic ash soils, read well above the range even when watering is right. On such a field, treat the soil moisture status as a guide.
  • EC often comes from a lab soil test. A lab mixes the soil with five parts water (a 1:5 extract), which gives a different number from a probe in the ground. When the crop only has the lab value, the target shows with “(lab test, 1:5)” after it, and its status is a guide only.
  • Targets describe established plants in active growth. Growth stage, variety and rootstock change what is right, so weigh the numbers against your own experience.

Day targets and night targets

The Targets for Tomato card in the evening, headed “Night targets, from the sun's position at this location.”: Air Temperature is judged against the night target of 13 to 18 °C, and VPD and CO₂ read “Daytime only” in the Status column

After sunset the night targets apply, and CO₂ and VPD read Daytime only.

After sunset the night targets apply, and CO₂ and VPD read Daytime only.

Air temperature and air humidity have one target for the day and another for the night. CropWatch decides which applies from the sun: while the sun is above the horizon at the location's position, the day targets apply, and after sunset the night targets take over. The page checks the time every minute, so the switch happens without reloading.

The line under the targets card's title says which set is in use: “Daytime targets, from the sun's position at this location.” or “Night targets, from the sun's position at this location.”

CO₂ and VPD only have daytime targets. At night their rows keep showing the daytime target for reference, and the Status column reads “Daytime only” instead of a verdict.

Why the location's position matters

Sunrise and sunset come from the latitude and longitude of the location the sensor belongs to. Without them CropWatch falls back to fixed hours, and the line under the targets card's title says so and asks you to set the location's position. With no position:

  • Day and night targets switch at 06:00 and 16:00, whatever the season.
  • The daily light goal is spread over 06:00 to 16:00 instead of the real day.
  • The “DLI Today” card says the day is assumed to end at 16:00 (“day assumed to end”), and pointing at that line explains that the location has no coordinates.
  • The daily advice uses fixed sunrise and sunset times too.

Set the position once in the location's settings, as described in Location settings. Every sensor at that location uses it.

Reading the targets card

The Targets for Tomato card with Reading, Now, Target and Status columns: Soil Moisture Slightly low, Soil Temperature Optimal, EC High against its lab test range, pH Optimal, Air Temperature Slightly high, Air Humidity Low, VPD Very high and CO₂ Very low

Each reading with its target and its place on the seven-step scale.

Each reading with its target and its place on the seven-step scale.

The card sits directly under the “Above & below ground” panel and has four columns:

  • “Reading”: which reading the row is about.
  • “Now”: the newest value, in your units (°F if you chose Fahrenheit).
  • “Target”: the crop's best range, for example 20 to 25 %. A target with only one end shows as “≥ 20 %” or “≤ 900 ppm”.
  • “Status”: where the reading sits, on the seven-step scale described below.

Rows appear only for readings the sensor sends, in this order: Soil Moisture, Soil Temperature, EC, pH, Air Temperature, Air Humidity, VPD and CO₂. A soil probe on its own shows the soil rows; a soil sensor that also measures the air adds the rest. VPD is worked out from air temperature and humidity.

A dash in the Target column means the crop has no value for that reading. A dash in the Status column means there is nothing to judge against, or the crop only has a limit that the reading has not passed. For example, a crop with only an upper limit for night humidity shows a dash until the humidity goes over the limit, then “Very high”.

The seven-step status scale

A reading outside its target range is graded by how far off it is, measured from the nearest end of the range as a share of that end. With a soil moisture target of 20 to 25 %, 10 % below the low end is 2 points (18 %) and 10 % above the high end is 2.5 points (27.5 %).

On that 20 to 25 % target, 19 % reads “Slightly low”, 17 % “Low” and 14 % “Very low”. On the high side, 27 % reads “Slightly high”, 30 % “High” and 32 % “Very high”. A reading past one of the crop's stress limits is always “Very low” or “Very high”, however close to the range it is.

The “Above & below ground” panel uses a shorter scale: “Too low”, “Low”, “Optimal”, “High” and “Too high”. There, “Low” and “High” (amber) cover anything outside the range, and “Too low” and “Too high” (red) mean past a stress limit. So a reading just under its range reads “Low” in the panel and “Slightly low” in the targets card. The targets card is the more precise of the two.

Status labels in the targets card
StatusColourWhat it means
Very lowRedMore than 25 % below the range, or below the crop's lower stress limit.
LowAmberBetween 10 % and 25 % below the range.
Slightly lowBlueUp to 10 % below the range.
OptimalGreenInside the range.
Slightly highBlueUp to 10 % above the range.
HighAmberBetween 10 % and 25 % above the range.
Very highRedMore than 25 % above the range, or above the crop's upper stress limit.

Targets on the chart and the panels

The Time series chart with only Soil Moisture switched on: the moisture line falls from 20.9 % to 18.2 % during the day and crosses below the dashed Tomato min line at 19.3 %, with the Tomato max line at 24.2 % above it

The Tomato min and Tomato max lines mark the crop's soil moisture range.

The Tomato min and Tomato max lines mark the crop's soil moisture range.
  • “Time series” chart: two green lines named after the crop, for example “Tomato min” and “Tomato max”, mark the ends of the range on the Soil Moisture, Soil Temperature, EC and pH lines, where the crop has a value. Air readings get no lines, because their target changes between day and night.
  • “Above & below ground” panel: each reading shows its newest value, the “Low”, “Avg” and “High” for the time range you picked, a bar with the target range shaded, and “Target” followed by the range. At night CO₂ shows “Daytime only” in place of a target. EC with only a lab-test target shows that range as a note and gets no chip.
  • VPD chart: the crop's daytime VPD target is drawn as a band. VPD explained covers what the number means.

Light targets: the daily goal and the hour's target

The Tomato PPFD gauge at 603 µmol/m²/s, below its target of 720 to 1,080 for 01:00 PM to 02:00 PM, and under it the DLI Today card: 11.4 mol/m²/day so far, Still needed 8.6, Falling short, sunset at 04:56 PM and a bar for each of the last 7 days

The light target for this hour, and how today's light total is going.

The light target for this hour, and how today's light total is going.

Light targets appear on soil sensors with a light sensor. They start from the crop's daily light goal in mol/m²/day, its DLI (PPFD and DLI explains the units), and use sunrise and sunset at the location's position.

The PPFD gauge is titled with the crop, for example “Tomato PPFD”. Its target covers the current clock hour only and is labelled “Target” followed by the hour, such as 10:00 to 11:00. CropWatch spreads the daily goal over the day by the sun's height at your location, so a midday hour gets a larger share than the hour after sunrise. The hour's target is its share of the goal, given as the light level the hour needs on average. If the crop's goal has no upper end, the hour's upper end is the crop's light saturation level. At night the label reads “Target (night)” and no band is drawn.

The “DLI Today” card adds up today's light so far and shows:

  • The daily goal, as “Target for Tomato:” and the range. While the sun is up, it adds how much light should have fallen by now (“expected by now”).
  • At the top right during the day: “Still needed” (light the day still needs), “Room left” (light that still fits inside the goal) or “Over target”, with “Falling short”, “On track”, “Target reached” or “Above target” beside it.
  • How much of the day's light is left and the time of sunset, and once 15 % of the day's light has fallen, where today ends at its current pace (“At today's pace”).
  • After sunset, a final “Status:” of “Very low”, “Slightly low”, “Low”, “Good”, “High” or “Very high”.
  • “Daily history”: one bar for each of the last 7 full days (days without readings are left out).

Today's light total is added up from the readings. A gap of more than an hour between readings is not filled in, so a radio outage lowers the total instead of inventing light.

The Growing advice card

A soil sensor with a crop gets a daily report in a card titled “Growing advice”, with a light bulb beside the title, just above the “History” table. The line under the title reads “Daily AI report for” and a date: the day the report covers, which is the day before it was written.

The chip at the top right sums up that day:

  • “Looking good” (green): everything that could be judged was within or close to its target. The card says no change is needed.
  • “Needs attention” (amber): at least one reading was off by more than a small margin, or the sensor's readings looked wrong.
  • “Outside safe limits” (red): at least one reading was past one of the crop's stress limits for 60 minutes or more in total.
  • “Not enough data” (grey): nothing could be judged, usually because the sensor sent readings for less than three quarters of the day's hours.

The card first appears after the overnight run that follows your choice of crop, so look for it the next morning.

What the advice card contains

The Growing advice card for Sun, November 8, marked Outside safe limits: a table of night-time air temperature, night-time relative humidity and daily light integral, the recommended actions Warmer nights, Lower night-time humidity and Increase light, the readings on target, and the What each value means panel opened

A day with cold nights and too little light, with the details panel open.

A day with cold nights and too little light, with the details panel open.

On a good day the card is short: a headline such as “Looking good: no changes needed” and a sentence saying everything was within or close to the crop's targets. When something needs action, the headline sits above four parts:

  1. A table with the columns “Measurement”, “Recorded”, “Target” and “Status”, one row per problem. “Recorded” gives the low or high end of the day and the average, for example “Low 6 °C; average 10.8 °C”. The low end leaves out the lowest tenth of the day's readings and the high end the highest tenth, so one brief dip or spike does not count. For daily light the value is the day's total.
  2. “Recommended actions”: one item per action, with a bold title such as “Warmer nights:” and what to do. When one action also fixes another problem, that problem's item says so: heating at night, for example, also lowers night humidity, and the humidity item gives the level heating should bring it to.
  3. “On target:” followed by the readings that were within or close to their targets.
  4. Two panels that open when pressed: “AI summary”, the same findings in plain sentences, and “What each value means”, one line per reading with its average, range, target and verdict. The verdicts are “Within target”, “Close to target”, “Needs attention” and “Outside safe limits”; a reading that was not judged says why.
Words in the Status column of the advice table
StatusWhat happened that day
Below targetThe reading spent the day mostly under its target.
Above targetThe reading spent the day mostly over its target.
Low end below target; average within targetThe average was fine, but the low end fell under the target, for example on cold early mornings.
Peak above target; average within targetThe average was fine, but the high end went over the target, for example on a hot afternoon.
Readings look invalidMany values were zero or impossible, or the reading stayed exactly the same for 12 hours. The action is to check the sensor: how it is installed, its wiring and its battery.

How the advice is made and when it updates

Once a day, shortly after midnight Japan time, CropWatch reports on the previous day, midnight to midnight, for every soil sensor that has a crop. The card always shows the newest report, and a report does not change during the day. Today's conditions appear in tomorrow's report; for right now, read the targets card.

Three things go into a report: this sensor's readings for that day (nothing from other sensors), the crop's targets, and sunrise and sunset at the location's position. For the report, daytime starts one hour after sunrise, because a greenhouse takes about an hour to warm up, and ends at sunset.

A fixed set of rules does the judging and works out every number, verdict and recommended action. The AI only words the “AI summary”, and its wording is checked before it is saved: text that adds a number, leaves out an action, or names a chemical or a dose is thrown out and fixed wording is used instead. The AI is never given your sensor's name, your location's name or your notes, and it runs on CropWatch's own computer, so your readings are not sent to an outside AI service.

Each reading gets one verdict for the day:

  • Within target: at least 90 % of the day's readings were inside the range.
  • Close to target: off by no more than a small margin, such as 1 °C for temperature or 5 % for humidity.
  • Needs attention: further off than that.
  • Outside safe limits: past a stress limit for 60 minutes or more in total.
  • Not assessed: the readings covered less than 75 % of the day's hours.

The advice gives soil moisture and soil EC no verdict unless CropWatch has set a range for that sensor's own soil, because the crop's moisture target assumes a loam soil and there is no reliable crop target for EC measured in the ground. Their lines under “What each value means” then say a target range needs setting for the field's soil. To have one set, contact CropWatch support. That range is used by the advice only; the targets card keeps using the crop's target. Light is judged on the day's total; the light level at any one moment is shown for reference.

Printing the advice

Press “Print” at the top right of the card. Your browser's print window opens with just this card: both panels open, the Print button left off, and light colours even if you use CropWatch in dark mode. Long reports run onto extra pages.

To keep a copy as a file, choose Save as PDF in the print window. The file name starts with “Growing advice” and the report's date.

What the advice does not do

  • It does not change anything. No heater, vent, valve or relay is switched by it, and no setting is changed.
  • It does not warn you. Nothing is sent by email or notification. For a warning when a reading goes out of range, set up an alert rule.
  • It does not name products or doses. For EC and pH it tells you to have the soil tested and talk to your extension adviser before changing fertilizer or adding anything to the soil.
  • It does not keep a history in the app. Only the newest report is shown.
  • It does not see your field. It knows one sensor's readings at one spot, and nothing about plant health, pests or the work done that day.

The advice is a second opinion, not a guarantee. Check the crop yourself before acting on it. The card's own footnote says the same: “Written by CropWatch AI from this sensor's readings. Every number comes from the rules, not the AI; use it alongside your own checks.”

Quick answers

  • There is no Growing advice card: the sensor needs a crop, and the first report arrives after the next overnight run. If it is still missing a day after you chose the crop, contact support.
  • The advice talks about yesterday: each report covers one finished day. The date under the title is that day.
  • Soil moisture always reads “Very high”, but the plants look fine: the crop's moisture target assumes a loam soil. Soils that hold more water, such as volcanic ash soils, read above it when watering is right.
  • The VPD, PPFD and DLI panels say “Awaiting sensor data”: they need a sensor that measures air and light. On a soil probe without those, they stay that way.
  • The line under the targets card mentions 06:00 and 16:00: the location has no position, so sunrise and sunset are assumed. See Location settings.
  • Can I change a crop's targets?: no. They are the same for everyone who picks that crop. If a value looks wrong for your area or variety, tell support.
  • My crop is not in the list: leave the sensor on “No crop” and tell support which crop you grow. Only CropWatch can add crops to the list.