Skip to content

Box Dimensions Documentation

Menu Location: Products > Boxes > Box Dimensions

Access Level: Manager and above

Last Updated: 2026-03-01

Overview

The Box Dimensions page allows you to define the physical dimensions and capacity of your shipping boxes. This information is used for shipping cost calculations, packing optimization, and determining how many products fit in each box size. Accurate box dimensions ensure efficient packing and accurate shipping quotes.

Primary Functions:

  • Define box sizes with length, width, and height measurements
  • Calculate box volume for packing optimization
  • Set maximum weight capacity for each box size
  • Support shipping carrier integrations
  • Track which box sizes are used for which subscription types

Page Layout

Header Section

  • Add New Box Dimension button - Create a new box size configuration
  • Search/Filter - Find specific box sizes

Main Content Area

Table displaying all box dimensions with columns:

  • Box Name - Descriptive name for this box size
  • Length - Box length in inches
  • Width - Box width in inches
  • Height - Box height in inches
  • Volume - Calculated cubic inches
  • Max Weight - Maximum weight capacity (lbs)
  • Active - Whether this box size is currently in use
  • Actions - Edit or delete box dimension

Understanding Box Measurements

Dimension Fields

Length, Width, Height:

  • Measured in inches (inside dimensions)
  • Order doesn't typically matter for volume calculations
  • Important for carrier shipping calculations
  • Use consistent measurement method (inside vs outside)

Volume:

  • Automatically calculated: Length × Width × Height
  • Displayed in cubic inches
  • Used for packing optimization
  • Helps determine product capacity

Max Weight:

  • Maximum safe weight for this box (in pounds)
  • Consider box strength, not just size
  • Affects shipping cost calculations
  • Includes product + packing materials weight

Creating Box Dimensions

Add a New Box Size

Steps:

  1. Click "Add New Box Dimension" button
  2. Enter Box Name (e.g., "Small Box", "Large Cooler")
  3. Enter Length (inches)
  4. Enter Width (inches)
  5. Enter Height (inches)
  6. Volume calculates automatically
  7. Enter Max Weight (pounds)
  8. Check "Active" if box is currently in use
  9. (Optional) Assign to specific box/subscription types
  10. Click "Save Box Dimension"

Requirements:

  • All dimension fields must be positive numbers
  • Max weight must be realistic for box strength
  • Box name should be descriptive and unique

Example:

  • Name: "Medium Insulated Box"
  • Length: 16"
  • Width: 12"
  • Height: 10"
  • Volume: 1,920 cubic inches (calculated)
  • Max Weight: 30 lbs

Editing Box Dimensions

Modify Existing Box Size

Steps:

  1. Find box in the list
  2. Click "Edit" icon
  3. Update dimensions or weight limits
  4. Volume recalculates automatically
  5. Click "Save Changes"

Impact:

  • Future packing calculations use new dimensions
  • Active orders may retain old dimensions
  • Shipping cost calculations update for new orders

Deactivating Box Dimensions

Mark Box as Inactive

Instead of deleting, mark as inactive:

Steps:

  1. Edit the box dimension
  2. Uncheck "Active" checkbox
  3. Save changes

Benefits:

  • Preserves historical data
  • Can reactivate if needed
  • Maintains order history references

Common Use Cases

Use Case 1: Set Up Standard Box Sizes

Goal: Configure your primary shipping boxes

Steps:

  1. Measure inside dimensions of each box type
  2. Create box dimension for each:
    • Small Box: 12" × 10" × 8"
    • Medium Box: 16" × 12" × 10"
    • Large Box: 20" × 16" × 12"
  3. Set max weights based on box strength:
    • Small: 20 lbs
    • Medium: 35 lbs
    • Large: 50 lbs
  4. Mark all as Active
  5. Assign to appropriate subscription box types

Result: System can calculate optimal box size for orders

Use Case 2: Configure Insulated Coolers

Goal: Set up dimensions for insulated shipping

Steps:

  1. Measure cooler inside dimensions (account for insulation)
  2. Create box dimension:
    • Name: "Large Insulated Cooler"
    • Dimensions: 18" × 14" × 12"
    • Max Weight: 40 lbs (account for ice packs)
  3. Assign to refrigerated box types
  4. Note: Include ice pack volume in calculations

Tip: Reduce usable volume by ~20% to account for insulation and ice packs

Use Case 3: Calculate Product Capacity

Goal: Determine how many products fit in each box

Steps:

  1. Review box volumes
  2. Calculate average product volumes
  3. Determine maximum products per box:
    • Account for packing materials
    • Leave 15-20% buffer space
    • Consider product shapes (not all volume is usable)
  4. Document capacity limits for packing team

Example:

  • Large Box: 3,840 cu in volume
  • Average product: 200 cu in
  • Packing materials: 500 cu in
  • Realistic capacity: 15-16 products

Use Case 4: Optimize Shipping Costs

Goal: Use smallest box that fits order

Steps:

  1. Configure all available box sizes
  2. Enable automatic box selection
  3. System selects smallest box that fits:
    • Total product volume
    • Max weight limit
    • Dimensional weight considerations
  4. Review packing reports to validate selections
  5. Adjust box assignments as needed

Savings: Using optimal box sizes reduces shipping costs

Use Case 5: Add Seasonal Box Size

Goal: Add special box for holiday orders

Steps:

  1. Create new box dimension:
    • Name: "Holiday Gift Box"
    • Dimensions: 14" × 14" × 6"
    • Max Weight: 25 lbs
  2. Mark as Active only during holiday season
  3. Assign to gift box products
  4. Deactivate after season ends

Benefit: Seasonal boxes optimized for gift presentation

Box Selection Logic

How System Selects Box Size

Automatic Selection Considers:

  1. Total Product Volume - Sum of all product volumes
  2. Box Volume - Must fit all products + packing materials
  3. Weight Limit - Total order weight must not exceed max
  4. Dimensional Weight - Some carriers charge by size, not weight
  5. Box Availability - Only Active boxes are considered

Selection Priority:

  1. Boxes that fit volume and weight requirements
  2. Smallest qualifying box (to minimize cost)
  3. Preferred box for subscription type if configured

Shipping Carrier Integration

Dimensional Weight

What is it? Carriers charge based on whichever is greater:

  • Actual weight
  • Dimensional weight (size-based calculation)

Calculation: Dimensional Weight = (L × W × H) / Divisor

Common Divisors:

  • Domestic: 139
  • International: 166

Example:

  • Box: 20" × 16" × 12" = 3,840 cu in
  • Dimensional Weight: 3,840 / 139 = 27.6 lbs
  • If actual weight is 15 lbs, carrier charges for 28 lbs

Impact: Accurate box dimensions ensure accurate shipping quotes

Troubleshooting

Box Not Appearing in Selection

Symptoms:

  • Created box but not showing in packing options

Solutions:

  1. Verify "Active" is checked
  2. Check box is assigned to subscription type if required
  3. Ensure dimensions and weight are filled in
  4. Refresh page or clear cache

Common Cause: Box marked as inactive

Shipping Costs Higher Than Expected

Symptoms:

  • Shipping charges seem too high for box size

Check:

  1. Calculate dimensional weight (L × W × H / 139)
  2. Compare to actual weight
  3. Carrier charges whichever is higher
  4. Consider using smaller box if possible

Solution: Optimize box selection or adjust dimensions

Box Too Small Warning

Symptoms:

  • System warns box can't fit order contents

Solutions:

  1. Review total product volume vs. box volume
  2. Check if products need to be split across multiple boxes
  3. Verify product volume calculations are accurate
  4. Consider using larger box size
  5. Remove items if customer approves

Calculation Check: Products volume + packing materials should not exceed 85% of box volume

Weight Limit Exceeded

Symptoms:

  • System prevents using box due to weight

Check:

  1. Calculate actual order weight
  2. Compare to box max weight setting
  3. Include packing materials in calculation
  4. Verify max weight is set correctly

Solutions:

  • Use larger, stronger box
  • Split order across multiple boxes
  • Adjust max weight if box can handle more
  • Boxes (admin-edit.php?table=boxes) - Subscription box products
  • Products (product_classifications_active.php) - Product volume settings
  • Orders (cust_order.php) - Box selection for individual orders
  • Shipping Settings - Carrier integration configuration

Typical Workflow:

  1. Measure physical boxes
  2. Create box dimensions on this page
  3. Assign dimensions to subscription box types
  4. System automatically selects optimal box for orders
  5. Packing team uses recommended box size

Permissions & Access

Required Access Level: Manager or higher

Access Level Capabilities:

  • Manager: Create, edit, view box dimensions
  • Administrator: All manager capabilities + delete, advanced configuration
  • Kiva Admin: All features + carrier integration settings

Restricted Features:

  • Delete Box Dimensions: Administrator or higher
  • Carrier Integration Settings: Kiva Admin only

Best Practices

Measurement Guidelines

  1. Measure consistently - Always use inside dimensions (usable space)
  2. Account for insulation - Subtract insulation thickness from dimensions
  3. Double-check measurements - Incorrect dimensions cause shipping issues
  4. Use consistent units - Always inches for length/width/height, pounds for weight
  5. Document measurement method - Note if inside vs outside dimensions

Box Configuration

  1. Start with actual boxes - Measure boxes you actually use, don't estimate
  2. Set realistic max weights - Consider box strength and carrier limits
  3. Account for packing materials - Include ice packs, padding, insulation in volume
  4. Test calculations - Verify box selection works correctly with sample orders
  5. Mark unused boxes inactive - Don't delete, deactivate for future reference

Volume Optimization

  1. Calculate usable volume - Not all cubic inches are usable (corners, shapes)
  2. Leave buffer space - Use 80-85% of volume for products, rest for packing
  3. Consider product shapes - Irregular shapes don't pack at 100% efficiency
  4. Account for ice packs - Frozen shipments need space for cooling materials
  5. Test real packing - Validate volume calculations with actual packing tests

Weight Management

  1. Include all materials - Box, products, ice, padding, insulation
  2. Set safe limits - Max weight should be below box failure point
  3. Consider handling - Very heavy boxes may need "Team Lift" warning
  4. Track actual weights - Compare actual packed weights to estimates
  5. Update as needed - Adjust max weights based on experience

Things to Avoid

  • Estimating dimensions without measuring
  • Setting max weight higher than box can safely handle
  • Forgetting to account for insulation thickness
  • Deleting boxes that have historical order references
  • Using outside dimensions when inside dimensions are needed

Quick Reference Card

Task Action/Location
Add new box size Click "Add New Box Dimension" button
Edit dimensions Click edit icon > Update fields > Save
Calculate volume System auto-calculates: L × W × H
Set weight limit Edit box > Enter Max Weight field
Activate/deactivate box Edit box > Check/uncheck Active
Assign to box type Edit box > Select associated box products
Calculate dimensional weight (L × W × H) / 139 for domestic
Check box capacity Volume × 0.85 = usable product space

FAQs

Should I measure inside or outside dimensions?

Inside dimensions (usable space). This is what actually fits products. Outside dimensions are only needed for carrier systems that specifically request them.

How do I account for insulation in coolers?

Subtract the insulation thickness from each dimension. If insulation is 2" thick on all sides, subtract 4" from length, 4" from width, and 4" from height.

What if my order is heavier than the dimensional weight?

Carrier charges whichever is higher. If actual weight (25 lbs) is higher than dimensional weight (20 lbs), you're charged for 25 lbs. Dimension weight only matters when it exceeds actual weight.

Can I have different box sizes for different subscription types?

Yes. Create multiple box dimensions and assign each to specific subscription box types. System will use appropriate box for each subscription.

How much volume should I reserve for packing materials?

Generally 15-20% of total box volume. More for frozen (ice packs take space), less for ambient products with minimal padding.

What happens if I change dimensions on an existing box?

Future orders use new dimensions. Historical orders retain the dimensions that were active when they were created. Shipping cost calculations for new orders will reflect the change.

Should I delete or deactivate unused boxes?

Deactivate. Deleting can break historical order references. Deactivating preserves data while removing from active use.

How do I know if my volume calculations are accurate?

Pack several real orders and compare actual fit to calculated capacity. Adjust product volumes or usable box percentage based on results.

Can the system select different box sizes for different orders?

Yes, if you have multiple active box sizes configured, the system can automatically select the optimal box for each order based on volume and weight.

Change Log

2026-03-01

  • Initial documentation created
  • All sections completed per template requirements
  • Included dimensional weight calculations
  • Added volume optimization guidance

End of Documentation

For additional help, contact your system administrator or Kiva Logic support.