Add Product Page Documentation¶
Menu Location: Products > Add Product
Access Level: Manager and above
Last Updated: 2026-03-01
Overview¶
The Add Product page is the interface for creating new products in your catalog. This page allows you to configure all product details including pricing, inventory, categorization, images, and availability settings.
Primary Functions:
- Create new products for online store and subscriptions
- Configure product pricing and inventory
- Upload product images and descriptions
- Set category and tag assignments
- Configure availability and visibility settings
- Set up product variants and options
- Define shipping requirements
Page Layout¶
Header Section¶
- Page Title: "Add New Product"
- Save Buttons: Save as Draft or Publish Product
- Preview Button: Preview how product appears to customers
Product Information Section¶
- Basic product details (name, SKU, description)
- Pricing fields
- Inventory tracking
- Product categorization
Media Section¶
- Product image upload
- Image gallery management
- Video embed options
Availability & Settings Section¶
- Publication status
- Availability dates
- Customer visibility settings
- Subscription eligibility
Shipping & Physical Properties¶
- Weight and dimensions
- Shipping requirements
- Temperature sensitivity
Basic Product Information¶
Product Name¶
Field: Product Name (required)
Guidelines:
- Use clear, descriptive names
- Include key attributes (size, variety, organic status)
- Avoid ALL CAPS unless brand name
- Keep under 100 characters for best display
Examples:
- "Organic Fuji Apples - 2 lb bag"
- "Free Range Chicken Breast - 1 lb"
- "Artisan Sourdough Bread - Whole Loaf"
Product SKU¶
Field: SKU/Product Code
Purpose:
- Unique identifier for inventory tracking
- Used in reports and integrations
- Helpful for warehouse management
Best Practices:
- Use consistent SKU format across products
- Include category code if applicable
- Keep SKUs simple but meaningful
- Cannot duplicate existing SKU
Example SKU Formats:
PROD-001,PROD-002(simple sequential)VEG-APPL-FJ-2LB(category-product-variant-size)12345(numeric only)
Product Description¶
Short Description:
- Displays in product listings
- 1-2 sentences maximum
- Highlight key selling points
- Enticing but accurate
Long Description:
- Full product details
- Benefits and features
- Usage suggestions
- Storage instructions
- Origin/sourcing information
- Nutritional highlights (not claims)
Formatting Tips:
- Use bullet points for readability
- Include preparation suggestions
- Mention certifications (organic, non-GMO)
- Add storage/handling instructions
Pricing¶
Base Price¶
Field: Price (required)
What to Enter:
- Regular selling price
- Do not include $ symbol (enter numbers only)
- Use two decimal places (e.g., 12.99)
Pricing Considerations:
- Compare to market rates
- Factor in sourcing costs
- Account for shrinkage/waste
- Consider wholesale vs. retail pricing
Sale Price¶
Field: Sale Price (optional)
How It Works:
- Shows strikethrough on regular price
- Displays sale price prominently
- Can set start and end dates
- Automatically reverts to regular price when sale ends
When to Use:
- Seasonal promotions
- Clearance of expiring inventory
- Special events or holidays
- Customer acquisition campaigns
Cost Price¶
Field: Cost/Wholesale Price (optional)
Purpose:
- Track profit margins
- Used in profit reports
- Helps with pricing decisions
- Not visible to customers
Wholesale Price Multiplier¶
Field: Wholesale Multiplier
How It Works:
- Percentage discount for wholesale customers
- Applied automatically to wholesale accounts
- Example: 0.80 = 20% off retail price
Inventory Management¶
Stock Tracking¶
Enable Stock Tracking:
- Check box to track inventory levels
- Uncheck for unlimited/non-tracked items
When to Track:
- Physical products with limited quantity
- Seasonal items
- Pre-portioned items
When NOT to Track:
- Made-to-order items
- Services
- Digital products
- Unlimited availability items
Stock Quantity¶
Field: Current Stock Level
Managing Stock:
- Set initial inventory when creating product
- Updates automatically when orders placed
- Manual adjustments available
- Low stock alerts can be configured
Stock Status¶
Options:
- In Stock - Available for purchase
- Out of Stock - Not available, hide from store
- Available on Backorder - Accept orders even when out of stock
Low Stock Threshold¶
Field: Low Stock Alert Level
Purpose:
- Receive notification when inventory runs low
- Helps prevent stockouts
- Time to reorder from vendors
Recommended Settings:
- Fast-moving items: Higher threshold
- Slow-moving items: Lower threshold
- Consider lead time from supplier
Product Categories¶
Primary Category¶
Field: Category (required)
Available Categories:
- Fruits
- Vegetables
- Meat & Poultry
- Dairy & Eggs
- Pantry Items
- Prepared Foods
- Beverages
- Add-ons & Extras
- (Custom categories per your system)
Selection:
- Choose primary category from dropdown
- Product appears in this section of store
- Category used for filtering and navigation
Additional Categories¶
Multiple Categories:
- Product can belong to multiple categories
- Check all applicable categories
- Helps customers find products multiple ways
Example:
- "Organic Apple Juice" could be in:
- Beverages (primary)
- Fruit Products
- Organic Items
Tags¶
Product Tags:
- Add descriptive tags for better searchability
- Used in search filters
- Helps with promotions and reporting
Common Tags:
- Organic
- Local
- Gluten-Free
- Vegan
- Seasonal
- Featured
- New Arrival
- Best Seller
Product Images¶
Main Product Image¶
Requirements:
- JPG, PNG, or WebP format
- Minimum 800x800 pixels recommended
- Square aspect ratio preferred
- Maximum file size: 5MB
Image Guidelines:
- Well-lit, clear photos
- White or neutral background
- Show product accurately
- No watermarks or text overlay
- Professional quality
Additional Images¶
Gallery Images:
- Upload up to 10 additional images
- Show different angles
- Display packaging
- Show product in use
- Include sizing reference
Drag to Reorder:
- First image is primary
- Arrange gallery order by dragging
- Customers see images in this order
Image Optimization Tips¶
- Use high-quality source images
- Crop to remove excess background
- Ensure accurate color representation
- Compress images before upload
- Use descriptive file names
Availability Settings¶
Publication Status¶
Options:
- Published - Live and visible to customers
- Draft - Saved but not visible to customers
- Scheduled - Automatically publish on future date
When to Use Draft:
- Product not ready to sell
- Waiting for images/details
- Seasonal items (prepare in advance)
- Testing and review
Availability Dates¶
Available From:
- Date product becomes available for purchase
- Useful for seasonal items
- Pre-order products
Available Until:
- Date product stops being available
- Automatic removal from store
- Good for limited-time offerings
Example Uses:
- Strawberries: Available May 1 - August 31
- Holiday Ham: Available November 15 - December 24
- Summer CSA Box: Available June 1 - September 30
Visibility Options¶
Show in Store:
- Check to display in online store
- Uncheck to hide from browse/search
- Product still accessible via direct link
Featured Product:
- Displays prominently on homepage
- Included in featured product carousel
- Limited number of featured slots
New Arrival:
- Displays "New" badge
- Shows in "New Products" section
- Automatically expires after set period (typically 30 days)
Subscription Settings¶
Available for Subscription¶
Field: Allow in Subscription Boxes
Options:
- Check box to make available for recurring orders
- Uncheck for one-time purchase only
Subscription Frequency:
- Weekly
- Bi-weekly
- Monthly
- Custom schedule
Box Eligibility¶
Included in Box Types:
- Check which subscription box types can include this product
- Example: Available in "Large Box" but not "Small Box"
- Helps manage box contents and pricing
Auto-Swap Eligibility¶
Allow Substitutions:
- Can this product be swapped for similar items?
- Used when product unavailable
- Maintains box value
Shipping & Physical Properties¶
Weight¶
Field: Product Weight
Units: Pounds and ounces or just pounds (decimal)
Why It Matters:
- Calculates shipping costs
- Determines box size needed
- Affects carrier selection
- Required for label generation
Be Accurate:
- Include packaging weight
- Weigh actual finished product
- Update if packaging changes
Dimensions¶
Fields: Length x Width x Height
Units: Inches
Purpose:
- Box size calculation
- Shipping cost accuracy
- Pallet planning for warehouse
Temperature Requirements¶
Options:
- Ambient (no temperature control)
- Refrigerated (32-40°F)
- Frozen (0°F or below)
Shipping Impact:
- Determines packaging needs
- Affects shipping method options
- Influences delivery scheduling
- Adds dry ice or gel packs if needed
Fragile/Special Handling¶
Checkboxes:
- Fragile - Handle with care
- Perishable - Short shelf life
- Requires separate packaging
- Hazardous materials (rare)
Vendor Information¶
Primary Vendor¶
Field: Supplier/Vendor
Select From:
- Dropdown of existing vendors
- Link to vendor detail page
- Used for reordering
Information Tracked:
- Where product is sourced
- Vendor contact for reorders
- Helps with inventory planning
Vendor SKU¶
Field: Vendor's Product Code
Purpose:
- How vendor identifies this product
- Useful when placing orders
- Reconciling invoices
Lead Time¶
Field: Days to Receive from Vendor
Use:
- Inventory planning
- Reorder timing
- Customer availability promises
Common Use Cases¶
Use Case 1: Add Simple Product¶
Goal: Create basic product for online store
Steps:
- Navigate to Products > Add Product
- Enter product name: "Organic Carrots - 1 lb"
- Enter SKU: "VEG-CAR-1LB"
- Set price: $3.99
- Select category: Vegetables
- Add tags: Organic, Local, Root Vegetables
- Upload product image
- Enter description with key details
- Set weight: 1.0 lb
- Enable stock tracking, set quantity: 50
- Click "Publish Product"
Result: Product appears in store immediately
Use Case 2: Add Seasonal Product with Availability Dates¶
Goal: Create product only available during specific months
Steps:
- Create new product
- Enter product details
- Under Availability Settings:
- Available From: May 1, 2026
- Available Until: August 31, 2026
- Set status to Published
- Save product
Result: Product automatically appears/disappears based on dates
Use Case 3: Add Product with Sale Price¶
Goal: Create product with promotional pricing
Steps:
- Create new product
- Enter regular price: $12.99
- Enter sale price: $9.99
- Set sale start date: Today
- Set sale end date: 7 days from now
- Check "Show sale badge"
- Publish product
Result: Product shows $12.99 crossed out, $9.99 sale price, automatically reverts after sale ends
Use Case 4: Add Subscription-Only Product¶
Goal: Product only available to subscription customers
Steps:
- Create new product
- Enter product details and pricing
- Under Visibility:
- Uncheck "Show in Store"
- Check "Available for Subscription"
- Select eligible box types
- Publish product
Result: Product doesn't appear in store but available in subscription boxes
Use Case 5: Add Product with Multiple Variants¶
Goal: Same product, different sizes/prices
Steps:
- Create base product
- Enter shared information (description, category, images)
- Add variants:
- Small (1 lb) - $5.99
- Medium (2 lb) - $10.99
- Large (3 lb) - $14.99
- Set SKUs for each variant
- Track inventory separately for each
- Publish product
Result: Customers see dropdown to select size
Troubleshooting¶
Product Won't Save¶
Symptoms:
- Error message appears
- Page reloads without saving
- Changes don't persist
Check:
- Verify all required fields are filled (name, price, category)
- Ensure SKU is unique (not already used)
- Check price format (numbers only, two decimals)
- Verify image file size under 5MB
- Check for special characters in fields
Common Causes:
- Missing required field
- Duplicate SKU
- Invalid price format
- Image too large
Product Not Appearing in Store¶
Symptoms:
- Product saved but not visible to customers
- Can't find in search
Check:
- Verify status is "Published" not "Draft"
- Check "Show in Store" is checked
- Verify availability dates include today
- Ensure product has inventory if stock tracking enabled
- Check category is active and visible
Images Not Uploading¶
Symptoms:
- Upload fails
- Error message
- Image doesn't appear
Solutions:
- Verify file is JPG, PNG, or WebP
- Check file size under 5MB
- Try compressing image
- Ensure image isn't corrupted
- Try different browser if issue persists
Inventory Not Tracking¶
Symptoms:
- Stock level doesn't decrease with orders
- Always shows "In Stock"
Check:
- Verify "Enable Stock Tracking" is checked
- Confirm initial stock quantity is set
- Check product variation settings
- Ensure orders are being marked as complete
Related Pages¶
- Products List - View and manage all products
- Product Categories - Organize product categories
- Vendors/Farms - Manage product suppliers
- Store Settings - Configure store-wide product settings
- Inventory Report - Track stock levels across all products
Typical Workflow:
- Products > Add Product
- Fill in all product details
- Upload images
- Save as Draft to review
- Preview how it appears to customers
- Publish when ready
- Monitor on Products List page
Permissions & Access¶
Required Access Level: Manager or higher
Access Level Capabilities:
- Manager: Create and edit all products, set pricing, manage inventory
- Administrator: All Manager capabilities + delete products, bulk operations
- Kiva Admin: All features + technical settings, integration testing
Restricted Features:
- Delete Product: Administrator only
- Bulk Import: Administrator only
- Advanced Settings: Kiva Admin only
Best Practices¶
Product Setup¶
- Use consistent naming conventions across similar products
- Always upload high-quality images
- Write detailed, accurate descriptions
- Set appropriate categories and tags
- Configure inventory tracking for physical goods
- Include vendor information for easy reordering
Pricing Strategy¶
- Research competitor pricing before setting prices
- Factor all costs (product, shipping, handling)
- Use sale pricing strategically for promotions
- Set cost price to track profit margins
- Review and adjust pricing quarterly
Inventory Management¶
- Set realistic low stock thresholds
- Enable tracking for all physical products
- Update stock levels when receiving shipments
- Review stock reports weekly
- Plan seasonal inventory in advance
Product Descriptions¶
- Lead with benefits, not just features
- Include preparation/usage suggestions
- Mention certifications and sourcing
- Keep descriptions accurate and honest
- Update descriptions seasonally as needed
Image Quality¶
- Use professional photography when possible
- Consistent background across product line
- Show product from multiple angles
- Include scale reference for size clarity
- Update images if packaging changes
Things to Avoid¶
- Publishing incomplete products
- Using low-quality or stock photos
- Creating duplicate products with same SKU
- Setting unrealistic availability dates
- Over-promising on product descriptions
- Forgetting to enable stock tracking
Quick Reference Card¶
| Task | Action/Location |
|---|---|
| Create new product | Products > Add Product |
| Set product name | Product Information > Name field |
| Add product SKU | Product Information > SKU field |
| Set price | Pricing > Price field |
| Upload image | Media > Upload Image button |
| Assign category | Categories > Select from dropdown |
| Add tags | Tags > Enter tag names |
| Enable inventory | Inventory > Check "Enable Stock Tracking" |
| Set stock level | Inventory > Stock Quantity field |
| Save as draft | Click "Save as Draft" button |
| Publish product | Click "Publish Product" button |
| Set availability dates | Availability > Date range fields |
| Make subscription eligible | Settings > Check "Allow in Subscriptions" |
| Preview product | Click "Preview" button |
FAQs¶
Can I edit a product after publishing it?¶
Yes, you can edit any product at any time. Changes appear immediately unless you save as draft.
What happens if I delete a product that's in customer orders?¶
Don't delete products in active orders. Instead, mark as "Out of Stock" and hide from store. Historical orders will still show the product.
How do I create product variations (like different sizes)?¶
Use the Variants section to add size, color, or other options. Each variant can have its own SKU, price, and inventory.
Can I bulk upload products instead of one at a time?¶
Yes, use the Products > Import tool to upload CSV file with multiple products. Template available for download.
What's the difference between Draft and Unpublished?¶
Draft means you're still working on it. Unpublished means it's ready but you've chosen not to show it yet. Both are hidden from customers.
How do I make a product featured on the homepage?¶
Check the "Featured Product" box in Availability Settings. Featured products rotate in homepage carousel.
Can I limit quantity per customer?¶
Yes, under Advanced Settings set "Maximum quantity per order" field.
What image size works best?¶
Minimum 800x800 pixels, ideally 1200x1200. Square aspect ratio. Under 5MB file size.
How do I handle products sold by weight with variable pricing?¶
Set base price per pound, enable "Price by weight" option, and set average weight. Final price calculates at fulfillment.
Can customers see the cost/wholesale price?¶
No, cost price is internal only. Customers only see the regular price and sale price if applicable.
End of Documentation
For additional help, contact your system administrator or Kiva Logic support.