Shopping Lists

Overview

WPL's shopping lists help you shop smarter with features like offline access, barcode scanning, nutrition analysis, and automatic organization by store section.

Creating a Shopping List

1. Navigate to the Shopping page from the main menu
2. Click New List or + Add Item
3. Name your list (optional, defaults to date)
4. Start adding items

Adding Items

Manual Entry

1. Type the product name in the add field
2. Optional: Add quantity and notes
3. Click Add or press Enter
4. Item appears in your list

Barcode Scanning

1. Click the barcode scan icon
2. Scan the product barcode
3. Product auto-added with nutrition info
4. Adjust quantity if needed

Learn more: Barcode Scanning Guide

From Recipes

1. Browse recipes in the Recipe section
2. Click "Add ingredients to shopping list"
3. Review the ingredient list
4. Items added with correct quantities

From Meal History

1. View past meals in your log
2. Click "Add to shopping list" on any meal
3. Ingredients extracted from meal photo/analysis
4. Review and confirm items

Organizing Your List

Auto-Categorization

Items automatically organize by store section:

• Produce
• Dairy & Eggs
• Meat & Seafood
• Bakery
• Frozen Foods
• Pantry & Dry Goods
• Beverages
• Snacks
• Health & Wellness

Custom Categories

• Create your own categories
• Drag items between sections
• Reorder sections to match your store layout
• Save custom organization for future lists

Priority Items

• Star important items
• Starred items appear at top
• Useful for sale items or priority purchases

Using Lists While Shopping

Offline Access

Shopping lists work perfectly in stores with poor reception:

• Open your list before entering the store
• Everything caches for offline use
• Check off items as you shop
• Changes sync automatically when back online

More details: Offline Mode Guide

Checking Off Items

• Tap the checkbox next to each item
• Checked items move to "Purchased" section
• Strikethrough shows what's complete
• Undo if you unchecked by mistake

In-Store Scanning

Use barcode scanning while shopping:

• Scan to verify correct product
• Compare nutrition against similar products
• See health scores and allergen warnings
• Add alternatives if primary choice unavailable

Guided Shopping Flow

Start an active shopping session to scan items as they go in your cart. WPL tracks your progress in real-time.

Starting a Session

1. Open your shopping list and tap Start Shopping
2. Your list switches to guided mode with a barcode scanner ready
3. Family members are notified that you are actively shopping

Scanning As You Shop

1. Scan each product barcode as it goes in your cart
2. The item checks off automatically and matches to your list
3. If the item is not on the list, you can add it on the fly via barcode or manual entry
4. End the session when done — purchased items sync to your kitchen inventory

Location-Aware Reminders

WPL can remind you when you are near stores you shop at frequently:

• Enable location reminders in Settings > Notifications
• When you are near a saved store (Walmart, Target, Kroger, etc.), WPL shows a notification with items you need
• Tap the notification to open your shopping list, ready to go

Family Visibility

During an active shopping session, family members can see:

• Which items you have already picked up
• Which items are still remaining on the list
• This prevents duplicate purchases when multiple people are out shopping

Smart Features

Nutrition Insights

View nutrition summaries for your entire list:

• Total estimated calories for all items
• Macro breakdown if purchasing meal ingredients
• Health score average
• Allergen warnings

Budget Tracking

• Optional: Add estimated prices to items
• Running total shown at bottom
• Compare against budget
• Track actual costs after shopping

Recurring Lists

• Save frequently-used lists as templates
• One-click to recreate weekly essentials list
• Automatically suggests items based on purchase history
• Edit template as needs change

Smart Suggestions

WPL suggests items based on:

• Items you buy regularly
• Products for meals you log frequently
• Healthier alternatives to current choices
• Seasonal produce recommendations

Sharing Lists

Family Sharing

Share lists with family members or caregivers:

1. Click the share icon on any list
2. Select family members to share with
3. Everyone sees real-time updates
4. Anyone can add items or check off purchases

Collaborative Shopping

Multiple people shopping? Split the list:

• Assign categories to different shoppers
• Each person checks off their items
• See who's getting what in real-time
• Coordinate to avoid duplicate purchases

Shopping for Health Goals

Goal-Aligned Recommendations

If you have active health goals, WPL suggests:

• High-protein foods for muscle building goals
• Low-calorie alternatives for weight loss
• Nutrient-dense foods for wellness goals
• Items that fit your macro targets

Dietary Restrictions

Set dietary preferences in settings:

• Gluten-free
• Dairy-free
• Vegan/Vegetarian
• Keto/Low-carb
• Nut allergies
• Custom restrictions

WPL flags items that don't match your preferences and suggests alternatives.

Shopping List Tips

Troubleshooting

List not saving

• Check internet connection (or use offline mode)
• Ensure list has a name
• Try refreshing the page

Items in wrong category

• Drag item to correct section
• System learns your preferences
• Report persistent issues for AI improvement

Can't share list

• Ensure recipient is in your family circle
• Check their notification permissions
• Try re-sharing the list

Next Steps