Quick Start
Get your store's AR-15 builder live in under an hour. No engineering experience required.
1
Create your partner account
Go to assemblear.com/partners/signup and create your account. You'll be asked to choose a plan and enter payment details for your 7-day free trial.
2
Upload your products
From your dashboard, go to Products → Import CSV. Download the template, fill in your products, and upload. Your products are live immediately.
3
Copy your embed code
From your dashboard, go to Embed Code. Copy the iframe snippet and paste it anywhere on your website — a product page, a dedicated build page, or your homepage.
4
You're live
Customers on your site can now browse your products in the AR-15 builder and click Buy to purchase directly from your store.
CSV Import
The fastest way to get your products into AssembleAR. Our importer automatically detects your column names — so you can export directly from Shopify, WooCommerce, or any platform and upload without renaming anything.
Platform export guides
Shopify
1.
Go to Products → Export
2.
Select "All products" and "CSV for Excel, Numbers, or other spreadsheet programs"
3.
Download the CSV
4.
Upload directly to AssembleAR — no changes needed
WooCommerce
1.
Go to WooCommerce → Products → Export
2.
Click Generate CSV
3.
Download the file
4.
Upload directly to AssembleAR — no changes needed
BigCommerce
1.
Go to Products → Export
2.
Select CSV format
3.
Download the file
4.
Upload directly to AssembleAR — no changes needed
Other platforms
1.
Export your product catalog as CSV from your platform
2.
Make sure it has columns for product name, price, URL, and image
3.
Upload to AssembleAR — we'll detect your columns automatically
Column auto-detection
You don't need to rename your columns. AssembleAR automatically maps common column names from all major platforms to our schema:
| Our field | Accepted column names |
|---|---|
title | title, name, product name, product title, item name, post title |
brand | brand, vendor, manufacturer, maker |
price | price, variant price, sale price, regular price, retail price |
image_url | image url, image src, image, picture, photo, thumbnail |
buy_url | buy url, url, link, product url, permalink, handle |
category | category, part, part category, type, product type |
sku | sku, variant sku, item code, product code, upc |
in_stock | in stock, stock, available, inventory, qty, quantity |
✓ Only title and buy_url (or their equivalents) are required. Everything else is optional.
CSV columns
| Column | Required | Description | Example |
|---|---|---|---|
title | Required | Full product name | Faxon 16" 5.56 Pencil Barrel |
buy_url | Required | Link to buy this product on your site | https://yourstore.com/products/barrel-123 |
category | Required | Must match one of the 31 valid categories exactly | Barrel |
brand | Optional | Manufacturer or brand name | Faxon Firearms |
price | Optional | Price in USD, numbers only | 299.99 |
image_url | Optional | Direct link to product image | https://yourstore.com/img/barrel.jpg |
Example CSV
This is what your CSV file should look like when opened in Excel or Google Sheets:
| title | brand | price | image_url | buy_url | category |
|---|---|---|---|---|---|
| Faxon 16in 5.56 Pencil Barrel | Faxon Firearms | 299.99 | https://yourstore.com/img/barrel.jpg | https://yourstore.com/products/barrel | Barrel |
| BCM BCG MPI Full Auto | Bravo Company | 189.99 | https://yourstore.com/img/bcg.jpg | https://yourstore.com/products/bcg | Bolt carrier group |
| Magpul MOE Carbine Stock | Magpul | 49.99 | https://yourstore.com/img/stock.jpg | https://yourstore.com/products/stock | Stock or Brace |
| Geissele SSA-E Trigger | Geissele | 240.00 | https://yourstore.com/img/trigger.jpg | https://yourstore.com/products/trigger | Trigger |
| BCM MCMR 15in Handguard | Bravo Company | 229.99 | https://yourstore.com/img/hg.jpg | https://yourstore.com/products/handguard | Handguard |
💡 Category values are shown in green. URL columns are truncated for display — use your full URLs in the actual file.
Valid categories
The category column must match one of these values exactly — including capitalization and punctuation. Click any chip to copy it.
Cart integration
AssembleAR can add all selected parts to your cart in one click — no page hopping between products. Here's how it works per platform:
Shopify
Your Shopify export includes a "Variant ID" column. We detect it automatically and build a one-click cart URL that adds all selected parts at once — no extra work needed.
WooCommerce
Add a "cart_url" column to your CSV with the add-to-cart URL for each product (e.g. https://yourstore.com/?add-to-cart=123). We will open each one when a customer clicks View Cart.
BigCommerce
Add a "cart_url" column with your BigCommerce add-to-cart URLs (e.g. https://yourstore.com/cart.php?action=add&product_id=123).
Custom platform
Add a "cart_url" column with whatever URL adds the product to your cart. If not provided, clicking View Cart opens the product page instead.
For Shopify stores — when all selected parts have variant IDs, the "View Cart" button becomes "Add All to Cart" and opens your Shopify cart with everything pre-added in one click.
Tips
You don't need to rename your columns — we automatically detect Shopify, WooCommerce, BigCommerce, and most other formats.
Products with missing title or URL will be skipped. We'll tell you how many were skipped after import.
If a category doesn't match any of our 31 categories, the product imports as Uncategorized. You can fix it manually.
You can import multiple times — each import adds new products without replacing existing ones.
For ongoing price updates or adding individual products, use the API instead of re-uploading your whole catalog.
API Reference
Use the API to sync products programmatically — ideal for keeping prices and availability current without manual uploads. Authenticate using your API key from the dashboard.
Authentication
Include your API key in the Authorization header on every request:
bash
Authorization: Bearer YOUR_API_KEY
âš Keep your API key private. Never expose it in client-side code or public repositories. You can regenerate it anytime from your dashboard.
Base URL
bash
https://assemblear.com/api/v1
Endpoints
/api/v1/productsAdd or update a single product (upsert by SKU)
/api/v1/productsList all your products
/api/v1/products/{sku}Update a product by SKU
/api/v1/products/{sku}Remove a product by SKU
/api/v1/products/bulkSync your entire catalog at once
Add or update a product
Use this endpoint to add a new product or update an existing one. Products are matched by sku — if a product with that SKU already exists it will be updated, otherwise a new one is created.
bash
curl -X POST https://assemblear.com/api/v1/products \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sku": "FAXON-16-556-PENCIL",
"title": "Faxon 16in 5.56 Pencil Barrel",
"brand": "Faxon Firearms",
"price": 299.99,
"category": "Barrel",
"buy_url": "https://yourstore.com/products/faxon-barrel",
"image_url": "https://yourstore.com/img/faxon-barrel.jpg",
"in_stock": true
}'Bulk sync your catalog
Send your entire catalog in one request. Use replace_all: true to remove products that are no longer in your catalog (full sync). Omit it to only add/update products (additive sync).
bash
curl -X POST https://assemblear.com/api/v1/products/bulk \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"replace_all": true,
"products": [
{
"sku": "FAXON-16-556",
"title": "Faxon 16in 5.56 Barrel",
"price": 299.99,
"category": "Barrel",
"buy_url": "https://yourstore.com/products/barrel"
},
{
"sku": "BCM-BCG-556",
"title": "BCM BCG MPI Full Auto",
"price": 189.99,
"category": "Bolt carrier group",
"buy_url": "https://yourstore.com/products/bcg"
}
]
}'JavaScript example
javascript
const response = await fetch('https://assemblear.com/api/v1/products', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
sku: 'FAXON-16-556-PENCIL',
title: 'Faxon 16in 5.56 Pencil Barrel',
price: 299.99,
category: 'Barrel',
buy_url: 'https://yourstore.com/products/barrel',
in_stock: true,
}),
});
const data = await response.json();
console.log(data); // { success: true, product_id: "..." }Price update example
To update just the price of an existing product without changing anything else:
bash
curl -X PUT https://assemblear.com/api/v1/products/FAXON-16-556-PENCIL \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "price": 279.99 }'Embed Guide
The AssembleAR builder embeds on any website with a single line of code. Your customers see only your products — they click Buy and are taken directly to your store.
iFrame embed (recommended)
The simplest option. Paste this anywhere in your HTML — a product page, a dedicated "Build Your Rifle" page, or your homepage.
html
<iframe src="https://assemblear.com/embed/YOUR_API_KEY" width="100%" height="900" frameborder="0" style="border: none; border-radius: 8px;" ></iframe>
Replace YOUR_API_KEY with the API key from your dashboard. The builder automatically loads only your products.
Script tag embed
Alternative option if you prefer a script tag over an iframe:
html
<script src="https://assemblear.com/embed.js" data-key="YOUR_API_KEY" data-height="900" ></script>
Where to place it
Dedicated build page
Create a page called "Build Your Rifle" and embed the full builder. Link to it from your nav and product pages.
Homepage hero
Use the embed as a main feature of your homepage to immediately engage visitors.
Category pages
Embed on your AR-15 category page so customers can start building right where they browse.
Featured build widget
You can also embed a specific saved build — great for showcasing a curated build on a blog post or landing page:
html
<iframe src="https://assemblear.com/embed/build/BUILD_ID" width="100%" height="600" frameborder="0" style="border: none; border-radius: 8px;" ></iframe>
Get the BUILD_ID from the Builds section of your dashboard.
FAQ
Q: Do customers buy from AssembleAR or from my store?
A: Directly from your store. Every Buy button in the builder links to your product page. AssembleAR is a planning tool — the transaction happens on your site.
Q: What happens when I update prices on my site?
A: If you update prices manually via CSV, you'd re-upload just the changed rows. If you use the API, send a PUT request with the new price for each changed product. We recommend setting up an automated nightly sync via API to keep prices current.
Q: Do I need to re-upload my entire CSV if I add new products?
A: No. Just upload a CSV with only the new products and they'll be added to your existing catalog. Alternatively use the API to add individual products without any file upload.
Q: What if my product doesn't fit any category?
A: Import it anyway and it will show as Uncategorized. Uncategorized products won't appear in the main builder but will still appear in featured builds you create manually.
Q: Can I have multiple embeds on different pages?
A: Yes — the same embed code works anywhere. All embeds share your product catalog and API key.
Q: How do I cancel my subscription?
A: Go to your partner dashboard → Subscription tab → "Open billing portal". From there you can cancel, update payment, or view invoices.
Q: Is there a limit on how many products I can upload?
A: No hard limit. The builder handles large catalogs well. For very large imports (10k+ products) we recommend using the bulk API endpoint instead of CSV.
Q: What analytics are available?
A: The Analytics dashboard in your partner portal shows how many products you have listed, featured builds, and embed usage. More detailed analytics are on the roadmap.
Still have questions?
Email us and we'll get back to you within 1 business day.
contact@assemblear.com