Assemblage Logo Assemblage

Assemblage Documentation

Learn how to set up bundles and configurators that automatically track inventory — and connect your store to Claude.

Table of Contents

1

Quick Start Guide

Get up and running in two steps — the app block install takes about 2 minutes, then Auto-Create handles the rest in 30 seconds.

Step 1: Install the App Block (2 minutes)

You must do this before creating any configurations. The app block is what displays your configurators and bundles to customers — and what triggers inventory deductions at checkout.

⚠️ Without the block installed, customers won't see your options and inventory won't be tracked. This is a one-time setup.

  1. From the Assemblage Dashboard, click "Complete Setup" in the setup banner
  2. You'll be taken to the Shopify Theme Editor
  3. In the left sidebar, find your product template
  4. Click "Add block" under "Product information"
  5. Find "Product Options" in the Apps section → click it
  6. Drag it just above or below your "Add to Cart" button
  7. Click Save in the top right
  8. Return to Assemblage and click "Verify Installation"

Once verified, Auto-Create appears on your dashboard and you're ready to build.

✨ Step 2: Use Auto-Create (30 seconds)

The fastest way to configure a product. After the app block is installed, an Auto-Create bar appears on your dashboard.

How it works:
  1. Search: Click the search bar and pick a product
  2. Auto-Detect: Assemblage analyses your product variants automatically
  3. Auto-Create: Options and inventory links are set up instantly
  4. Auto-Deploy: The assembly is deployed to your product immediately

🏂 Example: The Hidden Snowboard

You have "The Hidden Snowboard" with 3 variants: Small, Medium, Large.

  1. Click Auto-Create → Select "The Hidden Snowboard"
  2. Assemblage detects 3 variants and creates a "Size" option automatically
  3. Each size is linked to the correct inventory item
  4. The configurator is deployed instantly
  5. Done. Customers can now select their size on the product page

What Auto-Create builds:

  • Products with variants: a Visual Configurator with options pre-linked to inventory
  • Products without variants: an empty Standard Bundle ready for you to add components

Creating a Standard Bundle (manual)

Use this when your product is a fixed package — customers buy exactly what's in it, no choices.

🏂 Example: Complete Snowboard Package

A "Complete Snowboard Package" that includes a board, bindings, and boots — all pre-selected.

  1. Click "Create Configurable Product" → select "Standard Bundle"
  2. Pick Products (optional): assign products now or later
  3. Name it: e.g. "Snowboard Package Setup" — merchants see this, customers don't
  4. Add Components: use the product picker to add each item and set quantities
  5. Review & Create

What customers see: just your main product page. Components are tracked silently behind the scenes.

What happens on purchase: Assemblage atomically deducts each component from inventory the moment an order comes in.

Creating a Visual Configurator (manual)

Use this when customers choose their own options — size, colour, add-ons, etc.

🏂 Example: Build-Your-Own Snowboard

Customers pick their board size (150cm, 158cm, 165cm) and binding colour.

  1. Click "Create Configurable Product" → select "Visual Configurator"
  2. Pick Products (optional)
  3. Name it: e.g. "Custom Snowboard Builder"
  4. Add Options:
    • Click "Add Option" → choose "Dropdown" → label it "Board Size"
    • Click "Add Choice" → search for "Burton Custom 150cm" → select it → auto-filled
    • Repeat for 158cm and 165cm
    • Add a second option: "Binding Colour" using the Color Swatch type
  5. Auto-Included Components (optional): add hidden items like packaging
  6. Review & Create

What customers see: dropdown menus and colour swatches on the product page, powered by the app block.

What happens on purchase: the exact variants the customer chose are deducted from inventory automatically.

2

Understanding the Basics

What is an Assembly?

An Assembly is a reusable template — like a recipe that defines:

  • What items are included (bundles)
  • What choices customers can make (configurators)
  • How to track inventory for each option

Build it once, assign it to as many products as you need.

Product Manager

Your control centre showing which products have configurations assigned.

  • Green badge: everything linked and ready
  • Orange badge: product needs attention (usually a new deployment that needs variant links)
  • Actions: deploy, manage links, or unassign

How Inventory Tracking Works

Assemblage uses an event-driven architecture — no pulling of historical order data on page load.

Traditional Shopify: you sell a "Snowboard Package". Shopify tracks that product but has no idea it contains a board, bindings, and boots. Component inventory is never touched.

With Assemblage: when a customer checks out, Shopify fires an order webhook. Assemblage intercepts it, reads the selected variant GIDs from the line item properties, and fires an atomic GraphQL mutation to deduct stock from every component simultaneously — all or nothing. No partial oversells, even under simultaneous purchases.

This means the inventory numbers your team sees in Shopify are always accurate at the component level.

3

Advanced Features

Auto-Included Components

Items that ship with every order but customers don't choose — packaging, manuals, sticker packs. Stock is still deducted, invisibly.

🏂 Example

Every snowboard includes a safety manual and sticker pack. Customers never see these, but you need to track how many you have left.

  1. When creating or editing a Configurator, scroll to "Auto-Included Components"
  2. Click "Add included component" → search for "Safety Manual" → set quantity to 1
  3. Repeat for any other hidden items

Now every order — regardless of which configuration the customer chose — deducts those components automatically.

Deploying to Multiple Products

One assembly can power hundreds of product pages. Same option structure, each product linked to its own inventory.

🏂 Example

You built "Custom Snowboard Builder" for Burton boards. Now deploy it to Lib Tech and Ride boards too — same size/colour dropdowns, different inventory variants per brand.

  1. Go to Configurations → find your assembly → click Add
  2. Select the new product
  3. The product picker opens for each option — select the matching variants for that product
  4. Repeat for additional products

If a product shows "Needs Configuration" in Product Manager after deployment, it just means the variant links for that product haven't been set yet. Click the product and complete the picker.

Production Forecasting Advanced+

Assemblage calculates exactly how many complete kits you can build from your current component stock — across every location.

The calculation works by looking at every required component and option choice in the assembly, then finding the binding constraint — whichever component has the lowest buildable quantity given your current stock levels. That number is your maximum buildable kit count.

Example

Your Grooming Kit needs: Matte Clay (45 in stock), Beard Oil (12 in stock), Comb (89 in stock). The binding constraint is Beard Oil — so you can build a maximum of 12 complete kits before you need to reorder.

Reorder alerts fire automatically when a component crosses your threshold, so you're notified before you run out — not after.

Analytics & Trends Advanced+

Assemblage tracks order data via an event-driven counter system — meaning analytics reads are near-instant (typically under 50ms) and never hit Shopify's order API rate limits.

What's tracked:

  • Revenue & orders — total revenue and order count across all assemblies
  • Assembly performance — order count and revenue per assembly
  • Option trends — which individual choices customers pick most (useful for inventory planning)
  • Combination trends — which option pairings customers select together most often (useful for creating fixed bundles from popular combos)

All of this data is also queryable via the Claude integration in plain language — see Section 4.

4

Claude Integration

Assemblage connects to Claude via MCP (Model Context Protocol) — a direct, secure link between Claude and your live store data. Instead of opening a dashboard, you can ask questions and get instant answers in plain language.

Read-only queries are available on every plan. Write-actions that update your store are available on Advanced and Plus plans.

How to connect your store to Claude

Assemblage exposes an MCP server that Claude connects to via a secure OAuth 2.0 + PKCE flow. The whole setup takes under two minutes.

1

Make sure Assemblage is installed and active

You'll need an active Assemblage subscription. Any plan gives you read-only Claude access. Advanced and Plus plans unlock write-actions.

2

Open Claude.ai and go to Settings → Integrations

In the left sidebar, click your profile → SettingsIntegrations. Click Add integration.

3

Search for Assemblage and connect

Search for Assemblage in the integrations list. Click Connect and follow the OAuth prompts. You'll be asked to authorise your Shopify store — Claude will receive a short-lived token scoped only to your shop.

4

Start a new conversation and ask away

Open a new Claude conversation. Assemblage tools are now available — Claude can query your assemblies, inventory, and analytics in plain language without you opening a dashboard.

⚠️ Privacy: Claude's access is scoped to your shop domain only. The token is short-lived and stored securely. Assemblage does not share your store data with any third party. Claude cannot access another merchant's store.

What you can ask — all plans All Plans

These are read-only — Claude queries your live data and returns a plain-language answer. No changes are made to your store.

Customer Support

Paste a customer question and get an instant, accurate answer from your live assembly data.

"Does the Pro Kit include titanium screws?"

Uses: get_assembly_detail

Store Performance

Query revenue, order counts, and top-performing assemblies without opening a report.

"What's my best-selling configuration this month?"

Uses: get_analytics_summary

Config Health Check

Ask Claude to audit all assemblies for broken SKU links, unlinked choices, and missing components.

"Which of my configurators have broken links?"

Uses: find_broken_assemblies

Combination Insights

Find out which option pairings customers buy together most — useful for bundle ideas and stock planning.

"What are my most popular component combinations?"

Uses: get_combination_trends

Write-actions — Advanced+ Advanced+ Coming Soon

These actions make changes to your store on your behalf. Each requires your confirmation before executing.

Restock Agent

Claude reviews your production forecasts, identifies components at risk of stocking out, and drafts a purchase order — ready for your approval.

"Draft a PO for anything running out in the next 7 days."

Bundle Builder

Claude finds your most popular component combinations from real order data and creates a fixed bundle product — ready to promote.

"Turn my top combo into a bundle for the homepage."

Auto-Fix Broken Links

When Claude finds broken SKU links, it searches your Shopify inventory for the closest matching variants and patches the configurator automatically.

"Find and fix the broken links in my Summer Kit."

Full Tool Reference

These are the MCP tools Assemblage currently exposes to Claude. All tools are scoped to your shop — Claude cannot access another merchant's data.

Tool What it does Plan
list_assemblies Lists all assemblies with name, type, product count, and deployment count All
get_assembly_detail Full config for one assembly: options, choices, components, assigned products All
find_broken_assemblies Surfaces unlinked choices, empty option groups, missing components All
get_shop_status Current plan, trial status, theme block installation state All
get_analytics_summary Total revenue, orders, top assemblies, most popular options and combinations Adv+
get_assembly_performance Order count and revenue for a specific assembly Adv+
get_option_trends Ranked list of individual choices by order frequency Adv+
get_combination_trends Ranked list of option pairings customers select together Adv+
get_deployment_history When an assembly was published to the storefront over time Adv+
5

Common Questions

Bundle = fixed package. Customers buy exactly what's in it, no choices. Example: a first aid kit with 25 set items.

Configurator = customer choices. Example: a custom watch where they choose dial colour and strap material. Choose based on whether your product has options or not.
If any required component hits zero, the bundle or that configuration option becomes unavailable at checkout. Customers can't buy what you can't fulfil — which prevents overselling and the support headaches that follow.
Yes — that's one of Assemblage's core strengths. Build the logic once and deploy it to as many products as needed. Each product connects to its own inventory items but shares the same option structure and customer experience.
This happens when you deploy an existing assembly to a new product but haven't yet linked the specific inventory variants for that product.

Click the product in Product Manager → the picker opens for each option → select the correct inventory items → badge turns green.
Yes — the app block is required for everything. For configurators it displays the option UI. For bundles it runs silently and handles inventory deduction. Without it, checkout doesn't trigger component deductions regardless of your setup.
Use Auto-Create when: your product has variants (Size, Colour, Material), you want the fastest setup, you're configuring one product at a time.

Use manual creation when: creating bundles (Auto-Create can't guess what's in your bundle), deploying to multiple products at once, building complex multi-option setups, or reusing an assembly structure across different brands.

Most merchants use Auto-Create for 80% of their configurations.
Auto-Create only appears after the app block is installed and verified. Complete Step 1 of the Quick Start guide, click "Verify Installation", and Auto-Create will appear immediately.
Yes. Go to Configurations → click the assembly name → click "Edit". You can add or remove components, change options, and adjust quantities. Changes apply to all products using that assembly.
Bundles: no. Components are tracked silently behind the scenes.

Configurators: yes — customers see the options you've defined (dropdowns, swatches, buttons) displayed by the app block. That's the intended experience.
Assemblage exposes an MCP server that Claude connects to via a secure OAuth flow. In Claude, add the Assemblage MCP server URL — Claude will prompt you to authenticate and will then have access to your store's live data. No additional setup is required on the Assemblage side. See Section 4 for the full tool reference and plan requirements.
?

Still have questions?

We're here to help you get the most out of Assemblage.

Contact Support