Assemblage Logo Assemblage

Assemblage Documentation

Learn how to create bundles and configurators that automatically track inventory.

Table of Contents

1

Quick Start Guide

Get up and running in minutes with our streamlined two-step setup.

Step 1: Install the App Block (2-Minute Setup)

You must do this before creating assemblies. The app block displays your product options and bundles to customers.

⚠️ Important: Without this block installed, customers won't see your configurators or bundles on your store. This is a one-time setup that takes about 2 minutes.

  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, look for your product template
  4. Click "Add block" under "Product information"
  5. Find "Product Options" in the Apps section → Click it
  6. Drag it to where you want options to appear (usually just above or below the "Add to Cart" button)
  7. Click Save in the top right
  8. Return to Assemblage and click "Verify Installation"

That's it! Now your theme is ready and Auto-create will appear on your dashboard.

Alternative: Manual Creation (When Needed)

Use the manual wizard when you need more control or for complex setups.

Click "Create Assembly" to choose:

📦 Standard Bundle

For fixed packages where customers can't change what's inside.

Example: Starter Kit, Gift Box

🎨 Visual Configurator

For products where customers choose specific options.

Example: Custom Watch, Build-Your-Own PC

When to use manual creation:

  • Creating bundles with specific components (Auto-Create can't guess what's in your bundle)
  • Complex multi-option products (Size + Color combinations)
  • When you want to deploy to multiple products at once
  • Reusing an assembly structure across different brands

Creating a Standard Bundle (Manual Method)

Perfect for pre-packaged sets like a "Snowboard Starter Kit."

🏂 Example: Complete Snowboard Package

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

  1. Click "Create Assembly" → Select "Standard Bundle"
  2. Pick Products (Optional): Select products to deploy to, or add them later
  3. Name It: "Snowboard Package Setup" (only you see this)
  4. Add Components:
    • Click "Add Components"
    • The product picker opens → Search for "Burton Custom 158" → Select it
    • Search for "Union Bindings Large" → Add it
    • Search for "Burton Boots Size 10" → Add it
  5. Set Quantities: Each component shows quantity controls (usually 1 per item)
  6. Review & Create: Click "Create Assembly" to finish

What customers see: Just your main product page. They don't see individual components—those are tracked behind the scenes.

What happens on purchase: When a customer buys your "Complete Snowboard Package," Assemblage automatically deducts 1 board, 1 binding, and 1 pair of boots from your inventory.

Creating a Visual Configurator (Manual Method)

Perfect for products where customers choose their own options.

🏂 Example: Build-Your-Own Snowboard

You let customers pick their board size (150cm, 158cm, or 165cm), then choose their binding color.

  1. Click "Create Assembly" → Select "Visual Configurator"
  2. Pick Products (Optional): Select which products should use this configurator
  3. Name It: "Custom Snowboard Builder"
  4. Add Options: This is where customers make choices
    • Click "Add Option" → Choose "Dropdown"
    • Label it "Board Size"
    • Add choices:
      • Click "Add Choice" → The product picker opens immediately
      • Search for "Burton Custom 150cm" → Select it → Choice auto-filled!
      • Click "Add Choice" → Search for "Burton Custom 158cm" → Select it
      • Click "Add Choice" → Search for "Burton Custom 165cm" → Select it
    • Now add another option: "Binding Color" (use Color Swatch type)
      • Click "Add Choice" → Pick "Black Bindings" from picker → Choose color #000000
      • Click "Add Choice" → Pick "White Bindings" from picker → Choose color #FFFFFF
  5. Auto-Included Components (Optional): Add items like manuals that come with every order
  6. Review & Create: Click "Create Assembly" to finish

What customers see: On your product page, they'll see dropdown menus and color swatches (thanks to the app block you installed). They pick their options and click "Add to Cart".

What happens on purchase: When they choose "158cm Board + Black Bindings" and buy, those exact items are deducted from inventory—all tracked automatically by Assemblage.

2

Understanding the Basics

What is an Assembly?

Think of an Assembly as a reusable template. It's like a recipe that defines:

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

You create it once, then assign it to as many products as you want.

Product Manager

This is your control center for seeing which products have assemblies assigned.

  • All Configured: Green badge = Everything is linked and ready
  • Needs Configuration: Orange badge = Product needs attention (rare with new wizard)
  • Actions: Deploy assemblies, manage links, or unassign

Most of the time, you won't need to touch this because the wizard links everything automatically.

How Inventory Tracking Works

This is the magic of Assemblage:

Traditional Shopify: You sell a "Snowboard Package" product. Shopify tracks that product, but has no idea it contains a board, bindings, and boots. Your component inventory stays unchanged.

With Assemblage: Customer buys the package → Assemblage instantly deducts 1 board, 1 bindings, 1 boots from your actual component inventory. You always know what you have in stock.

3

Advanced Features

Auto-Included Components (Optional)

These are items that come with every order but customers don't choose them.

🏂 Example: Instruction Manual

Every snowboard you sell includes a safety manual and a sticker pack. Customers don't see these options, but inventory still needs to be tracked.

When creating a Configurator:

  1. After adding your options (board size, binding color, etc.)
  2. You'll see "Auto-Included Components (Optional)"
  3. Click "Add included component"
  4. The product picker opens → Search for "Safety Manual" → Select it → Set quantity to 1
  5. Add "Sticker Pack" the same way

Result: Now when someone buys ANY configuration, you automatically deduct 1 manual and 1 sticker pack from inventory—even though customers never saw those items.

⚠️ Important: Most assemblies don't need this. Skip it if your product is just the customer's choices.

Deploying to Multiple Products

One of the most powerful features is reusing your assembly across different products.

🏂 Example: Same Configurator, Different Brands

You created "Custom Snowboard Builder" for Burton boards. Now you want to use it for Lib Tech and Ride boards too.

How it works:

  1. Go to Assemblies → Find "Custom Snowboard Builder"
  2. Click Add
  3. Select your Lib Tech product
  4. When adding choices, the product picker opens for you to select the Lib Tech variants
  5. Repeat for Ride boards

The magic: Same dropdown structure ("Board Size"), same option labels ("150cm", "158cm", "165cm"), but each product connects to its own brand's inventory. Your customers see a consistent experience, and your inventory stays accurate.

Dashboard Metrics

Your home screen shows:

  • Total Assemblies: How many templates you've created
  • Products: How many products have assemblies assigned
  • Needs Attention: Products that need components selected (appears only when deploying to new products)

If "Needs Attention" shows 0, everything is configured and ready to sell!

4

Common Questions

For Bundles: No. Customers just see your main product (e.g., "Complete Snowboard Package"). The app block doesn't show anything for bundles—it works silently in the background tracking components.

For Configurators: Yes! Customers see dropdown menus, color swatches, or buttons to pick their options. The app block displays these options beautifully on your product page. That's the whole point—they're customizing their product.

If you sell a "Snowboard Package" that includes bindings, and bindings hit 0 inventory, customers can't buy the package anymore. The whole product becomes unavailable.

This is actually a good thing—it prevents overselling and angry customers!

This happens when you deploy an existing assembly to a new product, but haven't selected the specific inventory items for that product yet.

To fix it:

  1. Click on the product in Product Manager
  2. The product picker will open for each option that needs a variant selected
  3. Choose the correct inventory items for each option
  4. Once complete, the badge turns green: "All Configured"

Example: You deployed your "Snowboard Builder" (created for Burton) to a Lib Tech product. Now you need to select which Lib Tech boards correspond to "150cm", "158cm", etc.

Absolutely! That's the power of assemblies.

Example: You create "Snowboard Builder" with size/color options. You can deploy it to 50 different snowboard products. For each product, you link the specific variants that match.

Same structure (dropdowns, swatches), different inventory items.

Yes, you must install it for everything. Even though bundles don't display options to customers, the app block is still required for the inventory tracking to work properly.

Think of it like this: The app block is the "engine" that makes Assemblage work. For configurators, it also displays the UI. For bundles, it runs silently in the background.

Don't worry—it's a one-time setup that takes about 2 minutes. Just follow Step 1 in the Quick Start Guide above.

Bundle = Fixed Package: "This is what you get, no changes." Example: First aid kit with 25 set items.

Configurator = Customer Choices: "Pick your options." Example: Custom watch where they choose dial color and strap material.

Choose based on whether customers can customize or not.

Use Auto-Create when:

  • You have products with variants (Size, Color, Material)
  • You want the fastest setup (30 seconds)
  • You're configuring one product at a time
  • Your variants have SKUs (recommended but not required)

Use Manual Creation when:

  • Creating bundles (Auto-Create can't guess bundle components)
  • Deploying to multiple products at once
  • You need complex multi-option setups (Size + Color as separate groups)
  • Reusing an assembly structure across different products/brands

Pro tip: Most merchants use Auto-Create for 80% of their assemblies. It's fast and handles the common case perfectly. Use manual creation for the special cases.

If you use Auto-Create on a product with no variants (just "Default Title"), it will create an empty bundle for you.

To add options to your product:

  1. In Shopify, add variants to your product (Size, Color, etc.)
  2. Return to Assemblage and use Auto-Create again
  3. It will now detect your variants and create options automatically!

Alternatively, if you're selling a fixed bundle (like a gift set), you can use manual creation to add the specific components.

Auto-Create only appears after you've completed the app block installation (Step 1 above).

This is intentional—we want to make sure your theme is ready before you start creating assemblies. Otherwise, you'd create assemblies but customers wouldn't be able to see them!

To enable Auto-Create:

  1. Complete the 2-minute app block installation (see Step 1)
  2. Click "Verify Installation"
  3. Auto-Create will appear on your dashboard immediately

Yes! Go to Assemblies → Click the assembly name → Click "Edit" in the top right.

You can add/remove components, change options, adjust quantities, etc. Changes apply to all products using that assembly.

?

Still have questions?

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

Contact Support