Skip to main content

Importing and Updating Products

Lucas Judson avatar
Written by Lucas Judson
Updated over a week ago

Use the Product Uploader to create or update products in bulk. This tool supports detailed product setup, including tracking method, costs, ownership, and even initial inventory for certain product types.


βœ… What You Can Do

  • Create new products with complete metadata

  • Update existing products using the Distru ID

  • Assign categories, groups, owners, strains, and unit types

  • Optionally:

    • Add images

    • Create initial inventory (product/batch-tracked only)

    • Generate default batches and menu listings


🧾 Preparing Your CSV File

πŸ”» Step 1: Download the Template

  1. Go to Settings > Import Data > Products

  2. Click Download Template

Template includes all supported fields with placeholders for up to 4 images.


🧩 Step 2: Fill in Product Fields

Column

Required

Notes

Name

βœ…

Product name

SKU / UPC

Optional

Unique identifiers

Vendor / Brand

Optional

Must match existing company relationships

Owner

Optional

Full name of a Distru user

Featured / Inactive

Optional

true or false

Product Category / Subcategory / Group / Strain

Optional

Auto-created if valid

Leaflink Product

Optional

Must match a cached LL product name

MSRP / Unit Cost / Unit Price / Wholesale Price

Optional

Supports multiple price types

Unit Type Name

Optional

e.g. Each, Gram, etc.

Net Quantity per Unit / Serving

Optional

Used for COGS calculations

Tracking Method

Optional

One of: product, batch, package

Units per Case

Optional

Numeric

Thresholds (Min/Max)

Optional

Triggers stock alerts

External Name

Optional

Alternative identifier

Image Fields (Name + URLs)

Optional

Up to 4 images with rank, scope, etc.

Initial Inventory + Location

Optional

Only for product or batch-tracked items


πŸ“€ Uploading Your File

  1. Navigate to Import Products

  2. Upload your CSV

  3. Choose Create New or Update Existing

  4. Map your fields

  5. Submit

🎯 You’ll get a breakdown of inserted and updated products.
πŸ“Ž Errors return an annotated CSV.


πŸ”„ Update Mode Rules

  • Distru ID is required in each row to trigger updates

  • Fields left blank will be ignored

  • Cannot change the tracking method of an existing product

  • Initial inventory can only be added once, and not for package-tracked products

  • Default batch (B1) will be created unless tracking method is package or product is updated


⚠️ Validation Notes

  • Company relationships (Vendor/Brand) must be uniquely named

  • Images must include names and valid URLs

  • Inventory Location must exist and be mapped to your license

  • Leaflink Products must match existing entries in your LL cache

  • Net Quantities and Serving Unit Type must be coherent and matched if used


πŸ’‘ Pro Tips

  • Use ## to clear values (e.g. description or thresholds)

  • Attach images by specifying their URL + name; optional ranking helps with ordering

  • Adding new categories, subcategories, or groups in the file will auto-create them

  • Default batches and menu listings are auto-generated unless disabled

Did this answer your question?