Material tags

Material tags are reusable tag definitions managed under Settings → Tags. Each tag has a name and two opt-in flags:

• Default BOM tag — Assemblified writes this tag onto a Shopify product whenever a new BOM is created against it.
• Default raw-material tag — same, but for raw materials linked to a Shopify variant.

A tag with neither flag set is “manual only” — it lives in Assemblified but won’t be applied automatically. It’s still usable from Bulk BOM product tags.

Creating a tag

In Settings → Tags, click Add Tag. The dialog asks for:

Field	Notes
Name	Free-text, max 255 chars. This is the exact string written to Shopify. Unique across the shop.
Default BOM tag	If checked, the tag is queued onto any Shopify product when a new BOM is created against it.
Default raw-material tag	Same for raw materials linked to a Shopify variant.

Save, and the tag is ready. Marking the default flags doesn’t retro-apply — existing BOMs and raw materials keep their current Shopify tag set. Use Apply to all matching products now (the send icon in the table) to back-fill.

Applying to existing products

The send-arrow icon in the tags table enqueues the tag against every BOM (and/or raw material) that currently exists. This is the back-fill operation — useful right after you create a new default tag, or after a bulk import that bypassed the create flow.

The button is disabled for “manual only” tags. To back-fill those, use Bulk BOM product tags from the Finished Goods table.

Editing a tag

Editing only changes Assemblified’s record. Renaming assemblified-bom to bom-managed does not retag the Shopify products already carrying the old name — they keep assemblified-bom until you delete the old tag (with cleanup ticked) or re-apply the new one.

The pragmatic rename flow:

1. Edit the tag, give it the new name.
2. Click the send-arrow to write the new name to all matching products.
3. (Optional) Manually clean up the old tag name in Shopify if you want it gone.

Deleting a tag

The delete dialog has a checkbox: “Remove this Shopify tag from all matching BOM and raw-material products.” Two outcomes:

• Unchecked — the tag disappears from Assemblified Settings only. Shopify products keep the tag in place.
• Checked — Assemblified queues a tagsRemove against every matching product before deleting the record. The cleanup option is only available for default tags (BOM or raw-material).

Cleanup is one-way

There’s no undo on the cleanup pass. If you delete a default BOM tag with cleanup ticked, every Shopify product behind one of your BOMs will lose that tag.

How matching works

A “matching product” is any Shopify product (or variant, for raw materials) that:

• Has a Shopify product ID (numeric or gid://shopify/Product/...) — virtual materials and BOMs without a linked Shopify product are skipped silently.
• Is referenced by a row in bill_of_materials (for BOM tags) or raw_materials (for raw-material tags).

Jobs are chunked into batches of 250 products. Large catalogs may need a few minutes for the full pass to complete.

When you’d use this

• You want a quick way to filter “products managed by Assemblified” in the Shopify admin.
• You’re segmenting BOM-backed products for a Shopify automation (email flow, discount eligibility, theme section).
• You want raw-material variants to be flagged differently from finished-good variants in your catalog.

For per-order tagging (was this order BOM-handled or not?), see BOM order-status tags.