Settings reference

Each BOM has seven settings an operator can configure on the detail page. They live across three setting cards. This page is the authoritative reference for each one — what it does, when to use it, and what it costs.

On this page

• The three cards on the BOM detail page
• Status (active vs inactive)
• Reduction Settings (dynamic adjustment, maintain inventory level)
• Assemble Settings (auto-generate, keep-assembled, only-sell-preassembled)
• Pre-assembled quantity (numeric, not a switch)
• Subscription gates and mutually-exclusive pairs

At a glance

#	Setting	Card	Default	Subscription	Mutex
1	Status (active/inactive)	Status	Inactive	—	—
2	Dynamic adjustment	Reduction	Off	—	↔ #3
3	Maintain inventory level	Reduction	Off	—	↔ #2
4	Auto-generate material list	Assemble	Off	Enhanced	—
5	Keep assembled on return	Assemble	Off	—	—
6	Only sell pre-assembled qty	Assemble	Off	Enhanced	—
7	Pre-assembled quantity	(numeric)	0	—	—

The “mutex” column means: when one is on, the UI disables the other. They’re not both runnable at once.

1. Status (active vs inactive)

The on/off switch for the entire BOM.

• Active. Shopify order events execute this BOM and apply its component inventory changes.
• Inactive. Shopify order events skip this BOM entirely. No execution, no log row.

Default: Inactive.

Use it for: taking a BOM offline temporarily — recipe rework, an out-of-stock material you can’t substitute, testing a new recipe in the wings. Activating again is one click; nothing is lost.

2. Dynamic adjustment

Recalculate the Shopify-displayed quantity of this BOM from current component availability after every order.

• On. Assemblified recalculates this BOM’s sellable quantity from current essential raw material availability plus pre-assembled stock.
• Off. Assemblified will not recalculate this BOM’s sellable quantity from component availability.

Default: Off.

Mutex: disabled when Maintain inventory level is on.

Use it for: the typical case where you want your Shopify product page to never sell more than you can build. If your bottleneck component drops, the displayed quantity drops too.

There’s also a Synchronize with Raw Materials button that appears when this is on. It manually triggers a recompute — useful after you’ve edited components or fixed an inventory glitch and don’t want to wait for the next order.

See Dynamic adjustment for the formula and worked examples.

3. Maintain inventory level

The inverse of dynamic adjustment. After execution, push a positive delta back to the BOM variant so the displayed Shopify inventory stays flat.

• On. After order execution, Assemblified adds the executed quantity back to the BOM variant so the variant’s own Shopify inventory stays flat.
• Off. Shopify’s normal BOM variant inventory changes remain in place after order execution.

Default: Off.

Mutex: disabled when Dynamic adjustment is on.

Use it for: BOMs whose displayed Shopify quantity should be operator-managed manually (an “always 100” hand-curated number). The actual underlying components still decrement; only the displayed BOM quantity is restored.

4. Auto-generate material list

Create a Materials Order flow + linked TODO task for every order so operators can review or download the materials needed.

• On. Order execution for this BOM creates an auto-generated Materials Order flow and linked TODO task so you can review or download requirements.
• Off. Material lists will not be automatically generated for this BOM.

Default: Off.

Subscription: Enhanced. The Switch is disabled (with a “Enhanced Plan” badge) on the Free plan.

Use it for: workshops that pull a printed material list per order before building. Especially useful when component pickers want a checklist they can mark off.

5. Keep assembled on return

Cancelled or refunded units restore the BOM’s pre-assembled shelf instead of breaking back into raws.

• On. Cancelled or refunded units go back into this BOM’s pre-assembled stock instead of being broken back down into raw materials.
• Off. Cancelled or refunded units are broken back down into raw materials, while nested sub-assemblies can still keep their own assembled stock if flagged.

Default: Off.

Use it for: finished-goods that you can’t physically take apart — once assembled, they stay assembled. If a customer cancels, the unit goes back to your finished-goods shelf, not back to the raw-materials shelf.

This setting cascades through nested sub-assemblies. See Refunds & cancellations for the three-branch behavior table.

6. Only sell pre-assembled quantities

Cap Shopify availability at pre-assembled stock. Hide buildable capacity from raw materials.

• On. Shopify availability for this BOM follows pre-assembled stock only and ignores extra buildable quantity from raw materials.
• Off. Shopify availability is recalculated as max available quantity from pre-assembled stock plus component-derived capacity.

Default: Off.

Subscription: Enhanced.

Use it for: sellers who only want to sell what’s physically built — never sell on the promise of “we have raws, we’ll build it after the order”. When you flip this on, Assemblified opens a confirmation dialog showing per-location Shopify-vs-pre-assembled values, with two options:

• Set to Shopify Values — set pre-assembled per-location to match current Shopify-displayed inventory, so the storefront doesn’t suddenly drop to zero overnight.
• Keep Current — keep current pre-assembled values and let Shopify display drop to whatever pre-assembled is.

7. Pre-assembled quantity

The numeric count of pre-built finished goods. Not a switch — a number you adjust manually or through orders.

• Default: 0 — empty shelf.
• How to adjust: the BOM list page has a reconcile popover for quick changes. The detail page shows current per-location values. The “Only sell pre-assembled quantities” dialog also lets you seed the shelf to match Shopify.

When an order arrives, the shelf is consumed first; only the remainder pulls from raws. See Pre-assembled inventory for the full mechanics.

Subscription tiers

Two settings are gated to the Enhanced plan:

• Auto-generate material list (#4)
• Only sell pre-assembled quantities (#6)

The other five are available on all plans. The gate is enforced in the UI — the Switches render as disabled with a “Enhanced Plan” badge on the Free tier.

Where to next

• Pre-assembled inventory — deep dive on setting #7.
• Refunds & cancellations — deep dive on setting #5 with the cascade table.
• Dynamic adjustment — deep dive on settings #2 and #3.
• Execution model — see how settings translate to actual behavior at order time.
• Check BOM margin and cost breakdown — see how cost-related toggles interact with the rolled-up cost.