Manual Editing
After the optimizer produces a plan, you can adjust individual item placements by hand directly in the 3D viewport. Manual editing gives you precise control over the final arrangement — useful when you want to accommodate warehouse-specific constraints, loading sequence preferences, or operational requirements that are outside the scope of the automated optimizer.
Every manual edit triggers instant constraint revalidation. If a move creates a violation — overlap, weight limit exceeded, fragile item covered — LOP flags it immediately with a red highlight and a violation message.
Editor Tools
The viewport toolbar on the left side of the 3D view contains tools for interacting with placed items. Select the active tool by clicking the icon or pressing the keyboard shortcut.
Select (V)
The default tool. Click any item in the 3D viewport to select it. A selected item is highlighted with an outline. The item's details (name, dimensions, weight, position, rotation, constraint status) appear in the right panel.
With an item selected:
- Arrow keys nudge the item in small increments along the floor plane
- Ctrl+D duplicates the item and places the copy adjacent to the original
- Del removes the item's placement (moves it back to the Unplaced list)
Click on an empty area of the container to deselect.
Rotate (R)
Press R to enter Rotate Mode. When active, the Rotation Display panel appears in the top-right corner of the viewport.
Rotation Display panel:
- Shows three axis buttons: X, Y, Z
- Click an axis button to rotate the selected item 90° on that axis
- The current rotation is displayed as degrees: 0° / 90° / 180° / 270°
- Each click increments the rotation by 90°
While in Rotate Mode:
- Orbit and pan controls are disabled (to prevent accidental camera movement)
- Zoom still works (scroll wheel)
- Press R again or V to exit Rotate Mode and return to Select
For cuboid items, Rotate cycles through the 6 allowed orientations (LWH, WLH, LHW, HLW, WHL, HWL). For STEP items, rotation is applied as 90° quaternion increments on each axis, composing with the item's library orientation.
Rotate respects orientation restrictions set in the item's properties. If an item is marked as This Side Up, the Rotate tool will only cycle through orientations that keep the item upright. If only one rotation is allowed, clicking Rotate has no visible effect.
Delete (Del)
With the Select tool active, pressing Del removes the selected item's placement and moves it to the Unplaced Items section in the Items Panel. The item definition is not deleted — only the placement is removed. You can re-run the optimizer to place it again, or drag it back manually.
Dragging Items
With the Select tool active, click and hold on a placed item to drag it to a new position. Drag along the floor of the container to reposition laterally, or drag upward to lift the item and place it on top of another item.
LOP snaps items to valid positions as you drag — the item will automatically align to the floor, to the top surfaces of items below it, and to the walls of the container. Overlap detection prevents you from dropping an item into a space that is already occupied.
Dragging items in 3D takes some practice. If you are having trouble positioning an item precisely, use the arrow keys for small nudge adjustments after a rough drag, or enter exact coordinates directly in the position fields in the right panel.
Arrow Key Nudging
With an item selected (using the Select tool), the arrow keys move the item in 10 mm increments:
| Key | Direction |
|---|---|
| Arrow Left / Arrow Right | Move along the width axis (X) |
| Arrow Up / Arrow Down | Move along the depth axis (Z — toward/away from door) |
| Shift + Arrow Up / Down | Move along the height axis (Y — up/down) |
Hold Shift with the horizontal arrow keys to move in 50 mm increments instead of 10 mm.
Camera Controls
The 3D viewport camera lets you inspect the container from any angle.
| Action | Control |
|---|---|
| Orbit (rotate view) | Left-click and drag |
| Pan (shift view) | Right-click and drag |
| Zoom | Scroll wheel |
| Reset to default 3D view | Press 1 |
| Top-down view | Press 2 |
| Front view | Press 3 |
| Side view | Press 4 |
| Door-facing view | Press 5 |
| Fullscreen viewport | Press F |
Camera preset transitions use smooth spherical interpolation over 500 milliseconds. If you are looking for a specific item and cannot find it in the 3D view, switch to the Top view (press 2) for a clear overhead layout, or click the item's name in the Items Panel to highlight it in the viewport automatically.
Undo and Redo
All manual edits are tracked in a local undo history.
| Action | Shortcut |
|---|---|
| Undo last action | Ctrl+Z (Windows/Linux) or Cmd+Z (Mac) |
| Redo last undone action | Ctrl+Shift+Z or Cmd+Shift+Z |
The undo history holds the last 50 actions. Undo history is not persisted — if you reload the page, the history is cleared.
Running the optimizer counts as a single undoable action. You can undo a solver run and return to the arrangement you had before. This is useful if you ran the optimizer and the new arrangement is worse than your previous manual edits.
Keyboard Shortcut Reference
| Shortcut | Action |
|---|---|
| V or G | Activate Select tool |
| R | Toggle Rotate mode (opens Rotation Display panel) |
| Del | Remove selected item's placement |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z | Redo |
| Ctrl+D | Duplicate selected item |
| Arrow keys | Nudge selected item (10 mm increments) |
| Shift + Arrow keys | Nudge selected item (50 mm increments) |
| 1 | Camera preset: 3D perspective |
| 2 | Camera preset: Top-down |
| 3 | Camera preset: Front |
| 4 | Camera preset: Side |
| 5 | Camera preset: Door-facing |
| F | Toggle fullscreen viewport |
| I | Toggle Items Panel |
| D | Toggle Details Panel |
| Ctrl+S | Save plan |
| Ctrl+E | Export PDF |
Constraint Revalidation
Every edit — drag, nudge, rotate, or delete — triggers an immediate constraint check. The result appears within 100 milliseconds:
- Items with violations are highlighted in red in the 3D viewport
- The violation type is listed in the item's detail panel (e.g., "Overlap with Item #12", "Exceeds max payload")
- The score panel at the bottom updates to reflect the new arrangement
Hard constraint violations (overlap, outside container bounds, payload exceeded) must be resolved before exporting. Soft constraint warnings (low support ratio, CoG deviation) reduce the score but do not block export.
Next Steps
- Understanding Scores — how your edits affect each quality metric
- Constraints & Rules — full reference for hard and soft constraints
- Multi-Container Plans — editing across multiple containers