Get in touch
Questions, bugs and ideas are all welcome. If something isn't working, include your device, your iOS or Android version, the app version (at the bottom of Settings) and the name you go by in the app.
listnik@ilyav.netYour household
- Invite someone: Settings → Household → Invite Someone to Share gives a code. They enter it when they sign up, or with Join Another Household… in their own Settings → Household.
- Add a child: kids under 13 can't make an account of their own. Settings → Household → Add a Child gives a code they type or scan on their own phone, with Sign In with a Code. It works once, for 48 hours; for another device, tap the menu next to their name, then Sign In on a New Device.
- What's shared: everything. The list, the meals, the meal plan, stores and categories belong to the household, and every member can change them.
- Leaving: Settings → Household → Leave Household starts you over with an empty list. The others keep this one; if nobody's left, it's deleted. A child can't leave; a grown-up removes them.
- Removing someone: in Settings → Household, tap the menu next to their name, then Remove from Household. They start over with an empty list, and the invite codes they made stop working. Removing a child deletes their account.
- Notifications: when someone else adds or crosses off groceries, adds or removes a meal on the plan, or adds a recipe, you get a notification, with its photo if it has one; your own changes never notify you. Choose which in Settings → Notifications. Tapping one opens that item, that meal on the plan, or the recipe.
The list
- Add items: type in the search field and tap what you need. Matches stay after you add one, so “pota” adds potatoes and potato chips with a tap each; tap a ticked one again to take it back off, or just type to search for something else. If nothing's called that, Add and Add as a One-Time Item appear; one-time items are deleted once they're crossed off.
- Cross off: tap an item, or double-tap if you chose that in Settings → Cross Off With (adding from Not on List or a search is always a single tap). Undo appears for a few seconds, and shaking the phone undoes too.
- Details: the ⓘ button on a row opens its category, stores, notes and photo.
Stores and aisle order
- Aisle order: Settings → Stores & Aisle Order. Each store has its own order of categories; the list follows it when that store is picked.
- Pick a store: the store button at the top of Groceries. Its items stand out on the list; "Only [store] Items" hides the others.
- Auto-Select Store: turn it on in Settings and allow location while using the app. Listnik picks a store when you're within about 150 m of it while the app is open, and opening Listnik somewhere else goes back to All Stores. Stores need a location for this (Save Location Here in the store menu, or in the store's settings).
Sync
Changes reach the other phones in your household within a second or two while they're online. Offline, the app saves your changes and sends them in order when it's back. If a phone ever looks out of date, tap Sync Now in Settings.
Listnik Plus
Someone in my household bought Plus, but I don't have it
Plus belongs to the household. Make sure you're in the same household (Settings → Household lists its members), then tap Sync Now in Settings. The person who bought it can tap Restore Purchases if it still doesn't show.
Can I get a refund?
Refunds are handled by the store you bought Plus from. App Store: request one at reportaproblem.apple.com. Google Play: see Google Play's refund help.
Recipes from posts
In Instagram, Facebook or Safari, tap Share → Listnik. The app opens a New Meal with the recipe filled in for you to check before saving. If the recipe is only in the comments, paste its text into the sheet. Private posts and TikTok can't be read.
The API
Create a token in Settings → API Tokens & Devices (read-only, or with Allow changes on). Every request needs Authorization: Bearer lsk_…. The server's /llms.txt explains the API to AI assistants, and /openapi/v1.json is the full schema.
Reporting a problem
Something objectionable in your household, or someone misusing it? In Settings → Household, tap Report a Problem, or tap the menu next to a member and then Report; a photo opened full screen has Report Photo in its menu. Each opens an email to us with the details filled in; writing to the address above works too. We answer as soon as possible. What's not allowed is in the terms of use.
Deleting your account
On iPhone and iPad, Settings → Delete Account…, confirmed with Continue with Apple. On Android, Settings → Account → Delete Account, confirmed with Continue with Google. If you're the last member of your household, its list, meals and plan go too. Cancel Listnik Plus in the App Store or Google Play first: deleting the account doesn't. Delete your account explains what's deleted and what's kept, and how to ask by email if you can't open the app.
Copyright
To report a photo or recipe that infringes your copyright, see Copyright and takedowns in the terms of use.