Structure panel
The Structure panel draws a bill of materialsBill of MaterialsA bill of materials tells Assemblified how to build one unit of a finished good. When a customer orders the finished-good variant, Assemblified deducts the right component quantities from inventory automatically. Read more → as a graph: the finished good at the top, its components below it, and every assembly billSub-assemblyA reusable assembly block that composes into bigger bills: define it once, include it in any bill of materials, and Assemblified expands it into its own components at execution time. The app now calls it an assembly bill. Read more → (also called a sub-assembly) opened up to its own materials. It is a working surface, not a picture — you can add a component, change a quantity or remove a link without leaving it.
On this page
Section titled “On this page”- The four ways to open it
- What the canvas shows
- What one card tells you
- Pooled materials, and when to turn pooling off
- The node limit, collapsed assemblies and the hidden count
- Editing from the canvas
- Looking the other way: a raw material’s structure
The four ways to open it
Section titled “The four ways to open it”- From a finished good. On a BOM’s detail page, the Structure card shows a small preview. Open opens the full canvas for that one BOM.
- From an assembly bill. The same card, on an assembly bill’s detail page.
- From either list, for several at once. Tick the rows you want on Bill of Materials (the nav entry that opens the Finished goods list) or on Assembly Bills, then choose Open structure in the bulk bar. Every ticked bill becomes a root of one shared graph. You can also tick Select all matching first, as long as the result stays inside the limit below.
- From a raw material. A material’s page opens the same canvas the other way up — see Looking the other way.
Once you are on the canvas, Add bill in the title bar adds more roots to the graph you are looking at.
What the canvas shows
Section titled “What the canvas shows”Each card is one entity — a finished good, an assembly bill, or a raw materialRaw materialThe atomic component of a bill of materials or an assembly bill. Two flavours: a Shopify-linked variant, whose inventory Shopify tracks, or a virtual material, which Assemblified tracks on its own and Shopify never sees. Both sit in the same component picker and are consumed the same way. Read more → — and each line between two cards is one component link. The chip on the line reads the quantity it carries, then the waste percentage and the location pinned on that link, when either is set. Cards are colour-coded by kind, so a nested assembly bill is recognisable at a glance in someone else’s structure.
Click a card to select it. A click never navigates, but it does change what you are looking at: everything on a path through that card — its components all the way down, and everything that consumes it all the way up — stays lit, and the rest of the graph fades. That is how you read one bill inside a graph that draws several. Selecting also shows a small toolbar above the card.
Drag the canvas to pan and scroll to zoom. The control panel in the corner has zoom in, zoom out, Fit to screen, Rearrange (lay the graph out again), a lock, and the Pool materials switch described below. Cards can be dragged into your own arrangement from the start; the lock is what freezes that arrangement once you are happy with it.
What one card tells you
Section titled “What one card tells you”A card carries the entity’s image, name, SKU and — on a finished good — its product and variant name. Under that sit up to four figures, and what the second one means depends on what the card is:
| Card | Left-hand figures | Right-hand figures |
|---|---|---|
| Finished good | Pre (pre-assembled stock on the shelf) and Available Shopify, the stock Shopify holds for that variant | Cost (the rolled-up cost of everything below it) and Retail (the bill’s price) |
| Assembly bill | Pre and Max buildable, how many you could build from what is in stock right now | Unit (its own cost per unit) and Total (its rolled-up cost) |
| Raw material | Avail, the on-hand quantity | Cost |
Available Shopify and Max buildable are not the same question. On a finished good the figure is what Shopify says is sellable; on an assembly bill it is a calculation over the tree beneath it. Do not read one as the other.
Two more markers appear when they apply: a Pre-only badge on an assembly bill that only ever consumes pre-assembled stock, a Sell row where such an assembly caps what can be sold, a Root chip on the cards the graph was entered at (only when there is more than one), and a small grey Shopify marker on a material whose stock Shopify manages.
Pooled materials, and when to turn pooling off
Section titled “Pooled materials, and when to turn pooling off”By default the canvas is pooled: a material used by three different bills in the graph is drawn once, with three lines running into it. That is usually what you want — it answers “what does this whole set of bills consume” at a glance, and it keeps a wide graph readable.
Turn pooling off and the same material is drawn once per parent instead: one card per material-and-parent pair. Use that when you care about one bill’s own recipe rather than the shared picture — for example when checking a single quantity against a line on a work order.
The node limit, collapsed assemblies and the hidden count
Section titled “The node limit, collapsed assemblies and the hidden count”A graph is drawn up to 300 cards. Beyond that the canvas trims, in a fixed order, so that the result is the same every time you open the same link:
- Assembly bills collapse first. A collapsed assembly keeps its own card and hides only what is reachable through it alone. Expand on its toolbar loads that part and draws it again.
- Material leaves are dropped, deepest first, if collapsing was not enough. A banner then says how many cards are hidden.
Your roots and their direct children are never removed. If you routinely hit the limit, open fewer bills at once, or expand the one assembly you actually care about.
Editing from the canvas
Section titled “Editing from the canvas”Every edit is saved as you make it — there is no Save button on this page.
- Add a component. Select a finished-good or assembly-bill card and use Add component on its toolbar. The dialog offers three sources: Assembly bill, Virtual material and Shopify variant. Pick one, then the quantity it is consumed in.
- Change a quantity. Click the quantity chip on a link and set the new one.
- Remove a link. The delete control beside a quantity takes that component out of that one parent, after a confirmation. The material or assembly bill itself stays in your catalogue — only the link is removed, which is why removal is asked from a link rather than from a card: a pooled material has more than one parent. Once a link into a card is selected, the same Remove also appears on that card’s toolbar, so you can reach it from either end.
- Open the entity. Open on a card’s toolbar goes to that finished good’s, assembly bill’s or material’s own detail page.
Looking the other way: a raw material’s structure
Section titled “Looking the other way: a raw material’s structure”Opened from a raw material, the canvas turns the graph around: the material is the root at the top, and under it sits every assembly bill and finished good that consumes it, however deep the nesting. It is the fastest answer to “what breaks if this material runs out”.
A graph is one direction or the other, never both — materials and bills cannot be roots of the same canvas at the same time.
Where to next
Section titled “Where to next”- Composition — the same recipe as a table, on the BOM’s own page.
- Sub-assemblies overview — why a nested bill exists at all, and how it is expanded at order time.