Home/Docs/Inventory

Components

Manage the raw materials and services used to make your products.

Overview

Components represent the raw materials, services, and supplies used to create your products. The goal of components is to build a knowledge base of everything that goes into your products, then leverage that information for accurate pricing and cost of goods sold (COGS) calculations.

Create Component

Navigate to the Components page under Inventory > Components and click the Create Component button in the top right. Fill in the component details:

  • Name (required) — A descriptive name for the component
  • Category — The type of component (e.g., Metal, Stone, Packaging). New categories can be typed in and will be available for future use
  • Material Type — The specific material (e.g., 14k Gold, Sterling Silver)
  • Supplier — Where you source this component
  • Cost Per Unit — The price per unit of this component. The "unit" is whatever makes sense for the material (per gram, per carat, per inch, per piece, etc.). When you add this component to a product, you specify how many units are used, and the total cost is calculated as Cost Per Unit × Quantity.
  • Stock Quantity — How much of this component you have on hand
  • Color, Cut, Size/Gauge, Weight — Additional metadata fields for detailed tracking
  • Website Link — URL for the supplier or product page
  • Description — A detailed description of the component
  • Notes — Internal notes for your reference

Cost Per Unit

Components are priced by their unit of measurement. This makes it flexible for different kinds of materials and easy to use with products that consume varying amounts. Examples:

  • Gold could be priced per gram
  • Precious stones could be priced per carat
  • Painting services could be priced per inch
  • Packaging materials could be priced as all materials used to ship one product unit

Component Table

The components table displays all your active components with columns for Name, SKU, Category, Material Type, Supplier, Unit Cost, Stock Qty, Size/Gauge, Color, Cut, Weight, Description, Website, Supplier Order No., Notes, Created, and Status.

Filtering & Sorting

Use the filter toolbar above the table to narrow results by Category, Material Type, Supplier, Color, Cut, Size/Gauge, or Weight. Active filters display as dismissable chips below the toolbar. Click any column header to sort ascending or descending.

Column Visibility

Click the Columns button to toggle which columns are visible. Your preferences are saved automatically and persist across sessions.

CSV Export

Click the Export CSV button to download the currently displayed data as a CSV file. The export respects any active filters, so you can export a specific subset of your components.

Details & Update

Click the three-dot menu (...) on any row and select Edit to open the component details modal. From here you can update any field and save changes. You can also edit certain fields directly in the table by clicking on them.

Component Products

In the component details, click View Products to see a list of all products that use this component. This helps you understand the impact of price changes. The product list can be exported to CSV.

Auto-Consume on Sale (Beta)

When a product has Auto-Stock turned on (Beta) and uses this component, selling that product will automatically subtract the component quantity defined on the product from this component's on-hand stock.

Example: a Necklace product uses 1 Chain and 2 Charms. With Auto-Stock on, selling 1 Necklace decreases Chain by 1 and Charms by 2 with no extra steps.

In Inventory > Stock Management, the Components tab shows the resulting buildable count for every auto-stock product that uses each component, color-coded by tier so you can quickly spot which component is the bottleneck.

Bulk Upload

Click Bulk Upload to import multiple components at once from a CSV file. Download the template to get started — it includes all 16 component fields with instructions. Name and Category are required; all other fields are optional. AMS checks your data for errors before importing and flags similar values in autocomplete fields (Category, Material Type, Color, Size/Gauge, Cut, Weight, Supplier) to prevent duplicates. See the Bulk Upload guide under Getting Started for full details.

Copy & Add

Select Copy & Add from the row action menu to create a new component with the same field values as the selected one. This is useful for adding variations of existing components (e.g., the same stone in a different size). The original component is left unchanged.

Set Inactive

Components cannot be permanently deleted. Instead, they can be set to inactive by selecting Set Inactive from the row action menu. Inactive components are hidden from the default table view but can still be found by switching the status filter. To bring a component back, find it in the inactive view and select Reactivate.