Editing block details

Platform: Mobile and portal

A block has two kinds of detail you can edit:

• Name and variety — set when you create a block. The name is changed on the mobile app only; the variety can be changed on mobile (via the draft workflow) or corrected in the portal from the Maps block card.
• Planting settings and per-row counts — plant spacing, plants per bay, and the per-row block sheet. These can be edited on both the portal and the mobile app.

The boundary itself (the block's shape and rows) is re-drawn from the mobile app, in the field — see Mapping a block.

What you can edit

• Name — mobile only, while editing a draft block.
• Variety — mobile (while editing a draft block), or in the portal from the Maps block card (Admins and Managers).
• Plant spacing (metres) — portal and mobile.
• Plants per bay — portal and mobile.
• Per-row block-sheet values — actual plant and post counts per row — portal and mobile. (Subtractions are no longer typed in: active trouble spots subtract plants and posts automatically.)

Plant spacing and plants per bay drive the estimated plant counts. Leave them blank to inherit the vineyard default; see Editing planting settings below.

How edits relate to versions

• Planting settings (spacing, plants per bay) and block-sheet rows update in place — they do not create a new block version.
• Changing the boundary or rows (geometry) requires a Draft version, and is done on mobile.
• Name changes on a block that's already on the server go through the version workflow on mobile: create a new Draft, edit it, then release. See Block versioning. The same workflow covers variety, but a variety-only correction can instead be made in the portal — it updates the block in place with no new version.

Editing name and variety (mobile)

You edit a block's name and variety while it's open in the block editor (the block wizard). This is available for draft blocks — a brand-new block you're still creating, or a new draft of an existing block.

1. Open the block:

   • For a new or draft block, open the block editor from the vineyard.
   • For a block that's already released, open the block, then in Version History use the latest version's menu (the three dots) and choose New Draft. The new draft is selected for you; tap the pencil icon in the block's app bar (Edit Geometry) to open it in the editor.

2. At the top of the editor, the block's name and variety are shown with a small pencil icon. Tap them to open the Edit Block Details dialog.

3. In the dialog, update the Block Name and choose a Variety (Optional) from the list (None is the first entry). The same dialog holds the block's optional Planting overrides (Plant spacing, Plants per bay) and its Row numbers (First row, Last row — greyed once the block has been filled).

4. Tap Save. The changes are written to the local draft straight away and sync with it; a name already used by another block in the vineyard is refused ("A block with this name already exists in this vineyard").

5. If you created a new draft to make this change, release the draft when you're done so the new name/variety becomes the live version. See Block versioning.

Note: A block's name is not editable in the portal — to change it, use the mobile app.

Fixing a block's variety in the portal

If a block was mapped with the wrong variety in the field, you can correct it from the portal without a new version — an office fix, available to Managers, Admins, and SuperUsers:

1. Open Maps and select the vineyard.

2. Click the block to expand its card.

3. Next to the Variety value, click the pencil ("Edit variety").

4. Pick the correct variety in the dialog and click Save.

   

Saving updates the block card and the map colouring in place. Note:

• Variety is required, so there is no "none"/clear option — the picker always carries a real selection.
• This does not create a new block version — the block updates in place.

Editing planting settings

Plant spacing and plants per bay can be set at the vineyard level (the default) or overridden per block. A block that has no override inherits the vineyard default. Each value shows a small source chip that tells you where the number comes from:

• An override set on this block — shown as Block on the mobile app, and Set on block in the portal.
• The vineyard default — shown as Inherited on the mobile app, and From vineyard in the portal.
• Not set — no value on the block or the vineyard. Plant counts can't be estimated until spacing is set.

Leaving a field blank clears the block override, so the block falls back to the vineyard default.

In the portal

1. Open Maps and select the vineyard.

2. In the block list, click the block to expand it.

3. In the Planting section, click the pencil ("Edit plant spacing and bay").

   

4. Enter Spacing (m) and/or Plants per bay. Leave a field blank to inherit the vineyard default ("From vineyard").

5. Click Save.

On the mobile app

1. Open the vineyard, then tap the block to open its detail screen.

2. In the Planting section, tap Edit.

3. Enter Plant spacing (m) and/or Plants per bay. The placeholder shows the inherited vineyard value; leave a field blank to clear the override.

   

4. Tap Save.

Editing the block sheet (per-row counts)

The block sheet lists every row in the block with its length, the estimated plant and post counts, and editable actual counts. The sheet opens read-only; a pencil enters edit mode, where each row has an Actual (plants) and an Actual (posts) input beside the estimates. There is no per-row subtractions field — active trouble spots subtract plants and posts automatically — and no per-row reset button: clear a row by emptying its inputs, or use Reset all (asks for confirmation). Save also asks for confirmation before applying your overrides.

See Block sheet and planting settings for the full column-by-column reference.

In the portal

1. Expand the block in Maps (as above).

2. Click Block sheet in the Planting section.

3. Click the pencil ("Edit actual values"), type the actual plant and post counts per row, then click Save and confirm.

   

On the mobile app

1. Open the block's detail screen.
2. Tap Block sheet.
3. Tap the pencil, edit the per-row actuals, and tap Save in the bottom bar. The block's totals refresh to reflect the new overrides.

Re-drawing a block boundary

If you need to change the shape of a block — for example, because the original capture was wrong or because the planting has actually changed — that's done on the mobile app by capturing a new boundary. This creates a new Draft version of the block; the previously released version stays in place until you release the new one.

See Mapping a block for the capture workflow and Block versioning for how to release the new version.