Help & support
Answers to common questions. If your question isn't here, email support@chickaloonapps.com. Stub is supported directly by its developer.
Getting started
- Which devices does Stub run on?
- Mac with macOS 26.2 or later. iPhone and iPad (iOS 26.4 or later) are coming soon. One device is enough. If you use more than one, your receipts sync between them through iCloud.
- What are category bundles?
-
Category bundles are starting sets of categories for common kinds of work. You pick one the first time you open Stub, and you can change it later in Settings. The bundles are Ranch and Farm (Schedule F), Small Business, Independent Contractor and Real Estate Agent (Schedule C), Rental Property (Schedule E) and Household. Start Empty begins with no categories.
A bundle is only a starting point: add, rename or remove categories in Stub's Settings, under Categories. Your category list syncs through iCloud.
Adding receipts
- What are the ways to add a receipt?
-
- Scan the receipt with the document camera (iPhone and iPad).
- Import a photo from Photos, or an image or PDF from Files. You can pick several files at once and review each in turn.
- Share an image or PDF into Stub from another app's share sheet, up to 10 at a time. Shared receipts appear the next time you open Stub.
- Use Shortcuts or Siri: Add Receipt, or Scan Receipt on iPhone and iPad.
- On the Mac: File ▸ New Receipt from Files (⌘N) or New Receipt from Photos (⇧⌘N).
- My receipt is more than one page.
- Stub keeps one page per receipt: the first page of a scan or a PDF. For a long receipt, make sure the page with the vendor, date and total is the first one.
- Does Stub work without a network connection?
- Yes. Text recognition runs on your device, so you can capture and review receipts offline. Receipts added offline sync when you're back online.
- What does Stub read from a receipt?
- Stub reads the vendor, date, total, tax and line items. Recognition is set up for receipts in US English. Anything the scan gets wrong, you fix by typing over it: what you type always wins, and the scanned values stay on the receipt for reference.
Reviewing and organizing
- What does Needs Review mean?
- Every new receipt starts as Needs Review. When you've checked a receipt, choose Save & Mark Reviewed after a capture, or Mark Reviewed on the receipt. A badge on the app icon can show how many are left. The badge is on by default on the Mac (in the Dock) and off on iPhone and iPad; change it in Settings.
- How do I take personal items off a mixed receipt?
-
Open the receipt and, under Line Items, uncheck Include next to each personal item. The Total drops by those amounts.
Once a cross-out changes the Total, the receipt also shows the Transaction: the amount the receipt printed, which is what appears on your card statement. The CSV's Amount is the Total. Tax is not reduced by cross-outs.
- Why did Stub suggest a category?
- When you've filed receipts from a vendor before, Stub suggests the category you've used most for that vendor. You tap the suggestion to accept it; Stub never applies a category on its own.
- I corrected a store's name. Will Stub remember?
- Stub remembers a corrected name when you save the receipt from the review screen after a capture, or mark the receipt reviewed. Stub then uses your spelling on receipts from that store that you scan afterwards. Very short or generic names aren't learned, and receipts you already have aren't changed. See, add, edit and delete these rules in Settings ▸ Vendor Rules.
- What does search look at?
- Search looks at the vendor name and the text scanned from the receipt. Search doesn't look at notes, categories or the amounts you entered.
- Can I change many receipts at once?
- On the Mac, select several receipts, then right-click to mark them reviewed, set their category, copy or delete them. On iPhone and iPad, you change one receipt at a time.
- I deleted a receipt by mistake.
- Undo is available for about 10 seconds after a delete. After that, the receipt and its image are gone from every device it synced to.
On the Mac
- What is Review Mode?
- Review Mode is a way to work through a stack of receipts. Turn Review Mode on with ⇧⌘R. Each ⌘R marks the current receipt reviewed and moves to the next one that needs review. Review Mode turns itself off when no receipts need review.
- Keyboard shortcuts
-
- ⌥⌘↓ and ⌥⌘↑: next and previous receipt
- ⌘R: mark reviewed
- ⇧⌘R: Review Mode
- ⌘N: new receipt from Files; ⇧⌘N: from Photos
- ⌘E: export
- ⌘F: find
- ⌘1 to ⌘6: All Receipts, Needs Review, Reviewed, This Month, This Year, Date Range
- ⇧⌘I: open the receipt image in its own window; ⌥⌘I: show or hide the inspector
- ⌘⌫: delete; ⌘Z: undo
- Can I filter for receipts that still need work?
- On the Mac, the filters in the toolbar and the View menu narrow the list to receipts missing a category, missing an amount, with a low-confidence scan, or not yet reviewed. Date presets cover this tax year, last tax year, this quarter and last quarter. A tax year here is the calendar year.
Exporting
- What do I send my accountant?
- Export (⌘E on the Mac), choose CSV + Images, set Scope to Date Range with the year you're filing (January 1 to December 31), and keep Reviewed Only on. You get one ZIP file with the spreadsheet and every receipt's image.
- What's in the CSV?
-
One row per receipt, with the columns Date, Vendor, Amount, Tax, Category, Notes, Reviewed, ReceiptID and ImageFilename. Dates are YYYY-MM-DD, amounts have two decimals and no currency symbol, and Reviewed is yes or no. Line items aren't exported; the Amount is the receipt's Total after any cross-outs.
In CSV + Images, the ZIP holds
receipts.csvand the images in folders by year and month, named to match the ImageFilename column. - Why are some receipts missing from my export?
-
- Reviewed Only is on by default. Turn it off to include receipts that still need review.
- A date range uses each receipt's date. Turn on Include Undated to add receipts with no date.
- If an image hasn't finished syncing to this device yet, Stub warns you before exporting.
iCloud and your data
- How does sync work?
- Stub syncs receipts, their images and your vendor rules through your own private iCloud database, and your category list through iCloud key-value storage. There's no Stub account. Sync needs iCloud turned on for Stub on each device.
- What happens if iCloud is off?
- Without iCloud, Stub works normally, but receipts stay on the device where you added them. Settings shows the iCloud status.
- Where can I read more?
- The privacy page covers what Stub stores, where, and how to remove it.
Trial and purchase
- How does the trial work?
- Stub is free to download, with every feature open for 30 days. The trial starts on the day you capture your first receipt, on any of your devices, and counts calendar days. The trial doesn't restart if you delete receipts or reinstall.
- What happens when the trial ends?
- After the trial, your receipts stay viewable, searchable and exportable, and you can still delete them. Adding, editing and reviewing receipts need the unlock.
- What does the unlock cost?
- The unlock is a one-time purchase of $29.99 in the US (the App Store shows the price in your currency). It's not a subscription. One purchase covers iPhone, iPad and Mac, and it's shared with your Family Sharing group.
- I bought the unlock but Stub is still locked.
- Make sure you're signed in to the App Store with the Apple Account you bought it with, then choose Restore Purchases on Stub's unlock screen.
Contact
Email support@chickaloonapps.com. Include which device you use (iPhone, iPad or Mac), its system version, Stub's version from Settings, and what you tried. For a receipt Stub misread, attach the image if you can.