Logo

Creating Custom Cargo Spaces

You can add your own spaces in two ways: Excel Import or Manual Entry. Below is the exact behavior in the UI, updated with your corrections.

Add via Excel Import

Download the template:

Use Spaces → (expand panel) → Import Items → Download Excel Format to get the sample file.

What the two samples show:

Both Sample Space 1 and Sample Space 2 demonstrate the fields that must be completed according to the selected Space Type (e.g., Container vs. Lorry/Semi-Trailer/Trailer). By default, a Space Type requires Length, Width, and Max Load values. The Axle count can also be customized in Excel, just as it can be configured when adding a new Space Type in the CargoLoader3D interface. Use these samples as a reference for the required columns and possible customizations for each type.

Fill the template:

  • Required core columns:SpaceName, SpaceType, Length, Width, Height, Max Load. These columns must be present and filled in all templates, regardless of the selected Space Type. For Trailer, Semi-Trailer, and Lorry types, the Axle count is also required, with a minimum of two axles.
  • For vehicle types (Lorry / Semi-Trailer / Trailer), include axle blocks as needed:Distance, Tare Weight, Max Load per axle (Axle 1, Axle 2, …).
  • Units:the sheet has no unit metadata. Enter values in the same unit system currently active in the app (Metric or Imperial). There is no auto-conversion during import.
  • File name:any file name is fine.
  • Type names:SpaceType must match the types used in the app (Container, Lorry, Semi-Trailer, Trailer).

Import the file:

  • In the expanded Spaces panel choose Import Items → Import Excel Format, select your file.
  • If something is missing/invalid you’ll see a clear validation message (e.g., Missing information in Axle 1), and the import won’t proceed.
  • On success you’ll see “Spaces successfully inserted” and the new spaces appear in the list immediately.

Add via Manual Entry

Open the form:

Click Add New Space Item in the expanded Spaces panel to open the Add form. (Opening a custom space with the pencil icon shows an Edit form.)

Choose type & complete fields:

Select Space Type. The form adapts to the type:

  • Container:core dimensions + Max Load.
  • Lorry / Semi-Trailer / Trailer:core dimensions + Max Load, plus axle cards. Use the + tile to add an axle; each axle card can be removed via the trash (delete) icon.

Save / Cancel behavior:

  • Save validates and, if all rules pass, adds the space to the list immediately.
  • Cancel simply closes the form without saving changes (both in Add and Edit).

Editing & Copying

  • Default (system) spaces aren’t directly editable. Clicking the pencil opens a pre-filled Add form with the name prefixed by “Copy …”; saving creates a new custom space.
  • Your custom spaces are fully editable. The form header shows Edit; Save updates the record, Cancel closes without changes.

Notes & Tips

  • Create as many custom spaces as you need and name them freely.
  • Keep SpaceType within the app’s supported set (Container, Lorry, Semi-Trailer, Trailer).
  • Ensure your Excel values use the current app unit system; there’s no conversion during import.