Package Runs are the primary way to package bulk inventory from your lots into finished products (SKUs) in GrowerIQ. This article covers how to create a Package Run and understand the Package Run detail page.
In this article:
- What Are Package Runs?
- Prerequisites
- How to Create a Package Run
- Understanding the Package Run Detail Page
- Available Actions on a Package Run
- Tips and Best Practices
- Related Articles
🎯 What Are Package Runs?
A Package Run is a packaging operation that converts bulk material from a lot into finished, packaged products based on a specific SKU. For example, you might create a Package Run to package 100 units of a pre-roll SKU from a lot of dried cannabis.
Package Runs replaced the previous Lot Items workflow, consolidating all packaging data into a single, streamlined page. Each Package Run has its own detail page with a complete activity log, source lot information, and potency data.
Key benefits:
- Simplified packaging workflow with fewer steps
- Consolidated activity logs and audit trail on one page
- Full traceability from source lot to finished packaged product
- Support for THC/CBD potency tracking at the package level
✅ Prerequisites
Before creating a Package Run, ensure:
- You have a lot with available inventory (material to package)
- At least one SKU has been created that matches the lot's variety and end type
- The SKU must be in Enabled status
- The lot does not have a Recall flag (flagged lots cannot create Package Runs)
- You have the required warehouse permissions to access Package Runs
Managing SKUs
You can manage SKUs under Administration > SKUs. Only SKUs that are Enabled and match the lot's variety and end type will appear in the dropdown.
📝 How to Create a Package Run
Step 1: Navigate to the Lot
- Go to Warehouse > Lots from the sidebar menu
- Click on the lot you want to package from
Step 2: Open the Create Package Run Dialog
In the Actions panel on the lot detail page, click Create Package Run.
Button Visibility
This button is only visible when the lot has available inventory and no Recall flags.
Step 3: Select a SKU
From the SKU dropdown, select the SKU you want to package. Only SKUs that match the lot's variety and end type are shown.
Once selected, the dialog displays the SKU details:
| Detail | Description |
|---|---|
| End type | The product type (e.g., dried, oil, edible) |
| Unit quantity | Number of units per package |
| Unit weight | Weight per unit (in grams or g/unit for discrete items) |
| Target weight | Total cannabis weight per package (in grams) |
No SKUs Available?
If no SKUs appear in the dropdown, you need to create a SKU first under Administration > SKUs that matches this lot's variety and end type.
Step 4: Enter Quantity
Enter the number of items to create on this Package Run. The system validates that enough inventory is available in the lot.
Maximum Quantity
The maximum quantity is automatically calculated based on the lot's available inventory divided by the SKU's cannabis weight per unit.
For discrete unit types (e.g., plants, seeds), the dialog also shows:
- Discrete units to be packaged - the total number of individual units
- Total weight to be packaged - the combined weight in grams
Step 5: Name the Package Run (Optional)
Enter a Package Run Name to help you identify this run. This is optional but recommended for easy reference.
Step 6: Select Creation Date
Choose the package run creation date. The date must be between the lot creation date and today's date.
Past Month Date Selection
If you select a date in a previous month, this may affect regulatory reports (Health Canada, CRA) for that period. Contact GrowerIQ Support if you're unsure about the reporting implications.
Step 7: Select Storage Location
Select the location where the packaged items will be stored.
Step 8: Approve and Submit
Select the Approved By user from the dropdown to sign off on the Package Run, then click Submit.
The system will create the Package Run and transfer the required material from the source lot.
📊 Understanding the Package Run Detail Page
After creating a Package Run, you can view it by navigating to Warehouse > Package Runs and selecting the run, or by clicking the link from the lot's activity log.
The Package Run detail page displays:
| Property | Description |
|---|---|
| Current Quantity | Number of units currently available (not yet shipped or recycled) |
| Initial Quantity | Total number of units originally created |
| SKU | The SKU used for this Package Run |
| Created | Date the Package Run was created |
| Variety | Cannabis variety of the source material |
| THC | THC potency values (mg and/or percentage), if entered |
| CBD | CBD potency values (mg and/or percentage), if entered |
| Current Location | Where the packaged items are stored |
| Source Lot | Link(s) to the source lot(s) the material came from |
| Package Type | The type of package |
| Total Package Weight | Total weight of all packaged material |
| Remaining Weight | Weight of material still available |
| Multi Lot Original Info | For multi-lot runs only: shows each source lot ID and the quantity drawn from it |
THC/CBD Fields
THC and CBD fields only appear once potency values have been entered. You can add or update potency values using the Enter/Edit THC/CBD action.
The page also includes:
- Activity Log tab - Complete audit trail of all actions taken on this Package Run
- Documents tab - Any uploaded documents associated with this Package Run
- Barcode - Scannable barcode for the Package Run ID
⚡ Available Actions on a Package Run
From the Package Run detail page, you can perform several actions:
| Action | Description |
|---|---|
| Move Location | Move packaged items to a different storage location |
| Queue for Destruction | Send items to the destruction queue |
| Create Activity Log | Add a custom activity note |
| Enter/Edit THC/CBD | Record or update potency values |
| Print Label | Print a wholesale label for the Package Run |
| Revert Package Run | Undo the entire Package Run and return material to the source lot |
| Edit Package Run | Change the quantity (single-lot runs only) |
| Recycle Items | Unpackage material and return it to the source lot (single-lot runs) |
| Recycle Multi Lot Package Run | Unpackage material and return it to the correct source lots (multi-lot runs) |
| Edit Package Run Name | Update the display name |
| Batch Record | Download a PDF batch record |
Action Visibility
Some actions are only visible when certain conditions are met. For example, Revert only appears when there are no order allocations, and Edit is only available for single-lot runs.
Related Article
For details on Revert, Edit, and Recycle, see the companion article on managing Package Runs.
💡 Tips and Best Practices
- Name your Package Runs - While optional, a descriptive name makes it easier to find and manage runs later
- Check SKU availability first - If no SKUs appear in the dropdown, verify you have enabled SKUs matching the lot's variety and end type
- Review quantity carefully - The maximum quantity is calculated based on available lot inventory and the SKU's cannabis weight per unit
- Enter THC/CBD promptly - Potency values can be entered during lot creation or updated later from the Package Run page
- Use the Package Runs list - Navigate to Warehouse > Package Runs for a complete overview of all Package Runs across lots
Package Runs List
The Warehouse > Package Runs list page lets you search, filter, and sort all Package Runs across your facility -- useful for tracking packaging operations at scale.
🔗 Related Articles
- Multi-Lot Package Runs - Create Package Runs from multiple source lots
- Revert, Edit, and Recycle Package Runs - Manage and modify existing Package Runs
- Working With Lots - Understanding lot inventory management
- SKUs - Setting up and managing SKUs