Adding Library Items to Plans

Once your Item Library is populated, adding items to a load plan is quick. The editor's Items Panel connects directly to the library, letting you browse, search, and add items without leaving the planning view.

Opening the Add from Library Dialog

1. Open a load plan in the editor
2. In the Items Panel on the left side, switch to the Library tab (or use the ⋯ overflow menu → Add from Library)
3. The tab lists your library items, ready to add

Browsing and Searching

The Library tab lists every item in your organization's library, ordered by most used — the items that appear in the most plans come first. That order is fixed here; there is no sort control on this surface.

To search: type in the search box at the top. Results filter instantly by name and SKU.

There are no filter controls in this tab — no item-type, fragile, or 3D-model filters. If you need to narrow a large library by tag, or to see dimensions, thumbnails and usage counts, open the full Item Library page from the left sidebar.

Each row is compact and shows:

• The item's color swatch and name
• A processing badge for CAD items (so you can see whether a STEP/mesh part has finished processing)
• A gear icon if the item is an assembly with child components
• A quantity stepper and an Add button

Adding Items

To add a single item:

1. Click the item card — it highlights to confirm selection
2. Set the quantity in the quantity field that appears
3. Click Add to Plan

To add multiple different items in one operation:

1. Click the first item card — a checkbox appears selected
2. Click additional item cards to select them
3. Set quantities individually for each selected item using the quantity fields
4. Click Add Selected to Plan

All selected items are added to the plan's item list and appear in the Unplaced section of the Items Panel. Run the optimizer to place them.

Adding Assemblies

Assembly items are marked with a tree icon in the library browser. When you click to add an assembly:

1. A component preview panel opens showing all components and quantities
2. If the assembly has optional components, checkboxes allow you to deselect any
3. Set the quantity of assembly instances to add
4. Click Add Assembly to Plan

Mandatory components are added in the quantities defined by the assembly structure multiplied by the instance count. Optional components follow your selections.

Editing Item Properties for a Specific Plan

After adding a library item to a plan, you may need to adjust its properties for that particular shipment — for example, a different quantity, a weight that differs from the library value due to additional packaging, or a specific fragility setting for a customer order.

1. In the Items Panel, find the item in the Unplaced or Placed list
2. Click the item to select it
3. Click the edit (pencil) icon in the item details bar
4. Modify the properties
5. Click Save

These changes apply only to this instance in this plan. The library record is not modified.

Removing Items from a Plan

To remove an item that was added from the library:

1. Select the item in the Items Panel
2. Click the delete (trash) icon, or press Del on your keyboard with the item selected in the 3D viewport
3. The item is removed from the plan's item list

Removing an item from a plan does not affect the library record or any other plans.

Adding New Items Directly in the Editor

If an item you need does not exist in the library, you can create it directly in the editor without leaving the planning view:

1. In the Items Panel, click + Add Item (not "Add from Library")
2. Fill in the item properties in the inline form
3. Check Save to library if you want this item to be reusable in future plans
4. Click Add to Plan

If you check Save to library, the item is added to the Item Library simultaneously and appears there for future use.

Updating to Latest Library Version

Library edits reach your plans on their own. The next time you open a plan that uses the item, its copies pick up the current dimensions, canonical orientation and properties automatically — you do not need to remove and re-add anything, and existing placements are kept. If a dimension change could invalidate the arrangement, the plan shows a "layout outdated — re-solve" banner; re-run the optimizer to clear it. See Managing Library Items.