Upload receipt photos — items, prices and stores are extracted automatically
Upload Monthly Data
📁
Drop your Excel file here or click to browse
Expects an "All Transactions" sheet with columns: Date, Store, Receipt Name, Full Product Name, Category, Qty, Unit Price, Line Total, Non-Grocery?
Data Manager
Data is stored in this browser's localStorage. It does not sync across devices.
Groceries Dashboard — Help & Guide
Everything you need to know about tracking your grocery and household spending.
Getting Started
The Groceries Dashboard helps you track every item you buy from grocery stores each month. It breaks down your spending by store, category, and item — so you can see exactly where your money goes.
What you need: Photos of your grocery receipts. The Receipt Scanner will extract items, prices, and stores automatically.
How to Upload a Month
1
Click the "+ Upload Month" button in the navigation bar
2
Select "Scan Receipts" — this opens the Receipt Scanner
3
Upload your receipt photos (JPG, PNG, HEIC, PDF). You can upload multiple receipts at once
4
Choose a scan mode — AI-Powered (recommended, more accurate) or Offline OCR (no internet needed)
5
Review the extracted items — correct any names, categories, prices, or dates as needed
6
Choose "Import to Dashboard", select the month and year, then import. Your data appears immediately in the Groceries dashboard
Tip: If the scanner can't detect the date from a receipt, you'll need to select it manually before importing. The month and year are required fields.
Dashboard Tabs Guide
Overview — Summary cards showing total spend, item count, store count, and trip count. Includes spending breakdown chart and highlights.
By Store — See how much you spent at each store, how many trips, and percentage of total spending. Click any store for a detailed breakdown.
By Category — Spending grouped by product category (Produce, Dairy, Meat, etc.). Click any category to see all items in it.
All Items — Complete list of every item purchased. Click any item to edit its name or category.
Compare — Appears when you have 2+ months loaded. Compare spending side-by-side across months.
How Items Are Classified
The dashboard classifies each item into two types:
Grocery — Food and drink items (Non-Grocery = FALSE).
Non-Grocery — Non-food items like cleaning, personal care, household, paper products, electronics (Non-Grocery = TRUE).
Health & Beauty • Household & Cleaning • Paper Products • Personal Care • Cleaning Products • Electronics & Batteries • Clothing & Apparel • Baby Care (Non-Food) • Toys • Housewares
Tip: You can add new categories at any time. Just use a new category name in your spreadsheet and the dashboard will pick it up automatically. You can also edit item categories after uploading by clicking any item in the All Items tab.
Editing Items
Edit from All Items: Click any item row in the All Items tab to open the edit modal. You can change the product name and category.
Edit from Product Detail: When viewing a product's detail page, click the pencil icon next to the product name to rename it.
Autocomplete: When editing a product name, you'll see suggestions based on existing product names from all your loaded months. This helps keep names consistent across months.
Duplicate Detection
When you import a new month, some products may end up with slightly different names (e.g., "Boneless Chicken" vs "Boneless Chicken Breast"). The dashboard automatically flags these potential duplicates with an amber flag icon in the All Items tab.
Click the flag to see which product it matches. You'll have two options:
• Rename to Match — Opens the edit modal pre-filled with the matched name so you can unify the product names.
• Not a Duplicate — Dismisses the flag permanently if the items are genuinely different products.
Managing Your Data
Switch months: Use the month dropdown in the navigation bar to switch between uploaded months.
Manage Data: Click "Manage Data" to download a backup of all your data as a JSON file, restore from a previous backup, or delete individual months.
Compare months: Once you have 2 or more months loaded, the "Compare" tab appears to show side-by-side spending comparisons.
Bulk Actions
To act on multiple items at once, click the "Select" button above the All Items table to enter selection mode.
• Checkboxes will appear next to each row — check individual items or use the header checkbox to select all
• A floating action bar appears at the bottom showing how many are selected
• Change Category — Re-categorize all selected items at once
• Delete — Remove all selected items
Click "Cancel" to exit selection mode and hide the checkboxes.
Prices Nearby
When you view a product's detail page, the Prices Nearby card automatically checks current online prices at major grocery retailers (Walmart, Target, Kroger, Costco, and more).
• Location — On first use, you can share your GPS location or enter a zip code. This is used to show distance to nearby stores. Your location stays on your device.
• Caching — Results are cached for 48 hours to save API calls. Prices refresh automatically after that.
• Best Price — The cheapest option is highlighted in green with a "BEST" badge.
• Update Location — Click the "Update location" link below the price table to change your location.
Note: Prices shown are online/listed prices and may differ from in-store pricing.
Frequently Asked Questions
Q: What file types can I scan?
JPG, PNG, HEIC, and PDF files are all supported. You can upload multiple receipts at once.
Q: How do I mark non-food items (like batteries or toys)?
After scanning, edit the item category or mark it as Non-Grocery. These items are tracked separately in the dashboard.
Q: Where is my data stored?
All data is stored locally on your device (in your browser's localStorage). Nothing is sent to any server. Use "Manage Data" to download a backup.
Q: Can I use this on my phone?
Yes. The dashboard is fully responsive and works on mobile browsers. Upload and view your data from any device.
Q: What if a receipt name is hard to decode?
The AI scan mode automatically decodes receipt abbreviations into readable product names. You can also manually edit any item name after scanning.