Overview User Guide FAQ Your Lists Download

Welcome to the OurGroceries app! With OurGroceries you can keep track of your shopping lists and keep those lists instantly synchronized on all the smart phones in your household. You can also access those lists on your Amazon Alexa device, your Google Home, your computer, and your Android Wear smartwatch.

This user guide explains how OurGroceries works, so you can get the most out of it.

  • If you don’t find the answer you’re looking for here, or if there’s a feature you’d like to suggest we add, please don’t hesitate to contact us. You might also find the answer to your question in our list of Frequently Asked Questions.

Table of contents

Overview

OurGroceries is a mobile app that you can install on your iOS device (iPhone, iPad, or iPod touch) or Android device. It can keep track of multiple shopping lists and recipes.

You can set up “List sharing”, which means that if someone else in your household also installs the OurGroceries app, you’ll both see the same set of lists, and any change made to a list by either person will be seen by the other instantly. You can share with as many people as you want. Learn more

The OurGroceries app shows ads, but you can upgrade to get rid of the ads. Upgrading also gives you access to premium features, including taking photos of items and (on the Android app) scanning barcodes to look up items. Learn more

We also have a website associated with your account, and you can see and modify your shopping lists there. Learn more

If you have an Amazon Alexa device, such as an Amazon Echo, then you can set it up to know about your lists too, so that you can add items using your voice. Learn more

Similarly, if you have a Google Home, you can also use it to add items using your voice. Learn more

Finally, if you have an Android Wear watch, you can see your lists there too, which is convenient when shopping. Learn more

Installing

You can install OurGroceries from the app store on your phone or tablet.

On iPhone or iPad, you can find OurGroceries in the App Store. Launch the App Store app and search for “OurGroceries”. You can also tap on this button if you’re browsing this page on your phone:

On Android, you can find OurGroceries on the Play Store. Launch the Play Store app and search for “OurGroceries”. You can also tap on this button:

Get it on Google Play

If you wish to receive early testing versions of OurGroceries for Android, you may do so here: Join testing program. You can leave the testing program at any time.

There is also a web version of OurGroceries, so that you can see and edit your lists from your PC or from a smart phone for which we don’t have an app. Learn more

We have an OurGroceries skill that you can install on your Amazon Alexa device, such as the Amazon Echo. Learn more

We have an OurGroceries skill that you can install on your Google Home. Learn more

Basic use

When you initially launch OurGroceries, you’ll see a list of your shopping lists and recipes. You can tap a shopping list to see its items. From there you can add items, cross items off, or edit details of items.

Most people create one shopping list per store that they visit, such as one for “Safeway” and one for “Wal-Mart”. You can also create lists that aren’t store-related, such as a list of wines you want to buy (anywhere). And in fact some people create lists that aren’t shopping-related at all, such as list of things to bring camping, questions to ask the pediatrician, to-do list, etc.

You can also create recipes. A recipe is a list of items and some notes about the recipe (such as where you found it, or instructions for how to make the dish). Once you’ve made a recipe, you can tap the item names to add them to your shopping list. In fact you can add the entire recipe at once to your shopping list. Learn more

  • It’s important that you associate your lists with your email address, so that if you later upgrade your phone, you can find your lists again. Otherwise your lists are stored anonymously and you won’t be able to get them back if you re-install the OurGroceries app or change phones. Entering your email address is also necessary if you want to share your lists with family members. Learn more

Adding items

While looking at a shopping list or recipe, you can add items by tapping the “Add an item...” line at the bottom of the list of items. Alternatively, you can tap the “+” icon at the top-right of the screen. This will bring up the “Add an item” screen. On this screen you can type an item name using the keyboard, for example, “peanut butter”. You can then tap the “Add” button to add the item to your list.

We remember all the items you’ve ever entered and display them on this screen, so you can also just tap the item name. (We call this list the “master list”.)

To make it easier to find items in the long list, just type the first letter or two of the item you’re looking for and the list will shorten to include only items that start with those letters. This also works with multiple words. For example, you can type “pe bu” to find “peanut butter”. Or perhaps you typed “cookie”, which listed all the cookies in your master list. You can add “ch” to that (making it “cookie ch”) to narrow the list down to just “chocolate chip cookies”.

If you find an item on this list that you no longer want listed there, tap the at the right of the item name to delete it.

There are various settings to configure how this screen works:

Another way to add an item to your list is to uncross it off. See the next section of this user manual for details, but essentially you can keep items crossed off between shopping trips and tap them to add them back to your list.

Crossing items off

While shopping you’ll want to cross items off your list as you add them to your cart. Cross items off by tapping them. This marks them with a horizontal cross-off line and moves them to the bottom of the list, in the section called “Crossed off”. You can tap them there to un-cross them off and bring them back to the top of the list.

If you find that you cross off items by accident while shopping, you can configure OurGroceries to require more than a tap to cross items off. On the iPhone app you can require a swipe gesture, and on the Android app you can require a long-tap. Learn more

You can also configure how the crossed-off section is ordered. You can choose from alphabetical, recently crossed-off at the bottom, or recently crossed-off at the top. Keeping recently crossed-off items at the top is useful so that if you accidentally cross off an item, you can find it easily at the top of the crossed-off section. Learn more

Editing item information

If you want more information about an item, tap the icon to the right of the item name. This will bring you to a screen where you can see and change various things about an item.

To change the item name, tap into the box where the name is displayed and edit the text.

To change the quantity of an item, tap the “Fewer” or “More” buttons. This will decrease or increase the count in parentheses after the item name. For example, if the item is “Potatoes”, tapping “More” will change the item name to “Potatoes (2)”. There’s nothing special about these parentheses and this number—they’re just part of the name like the rest of it. You can tap in the text box and edit the number directly, too.

You can categorize items by tapping the “Category” selector and choosing a category. Learn more about how to use categories.

In the Android app, you can tap the “Scan Barcode” button to scan a product’s barcode. This feature is only available if you’ve upgraded the app. Learn more about how to use barcode scanning.

For items in shopping lists, you can move them to a different shopping list by tapping the “Shopping List” button and selecting a different list. There’s currently no way to copy the item to a different list (and leave the item also in this list).

For items in recipes, you can change the target shopping list this item is added to when it is tapped. Learn more about recipes

To delete the item, tap the trashcan icon. This removes the item completely from this list.

You can star an item by tapping the star icon. There’s nothing special about the star status—what it means is entirely up to you. For example, a star might indicate that you have a coupon for this item, or that this item is urgently needed, or that a particular person is responsible for buying this item. Tap the star again to un-star the item. Items that are starred will show a star icon in the shopping list itself.

Finally, you can take a photo of the item, to insure that your partner gets exactly the item you want. This feature is only available if you’ve upgraded the app. Learn more about how to use photos.

Sharing lists (setting up an account)

The app is called “Our” Groceries because it addresses the problem of a household needing to keep track of what needs to be purchased at the grocery store. Anyone in the household can add items to any list, and the next person to shop will automatically see what was added.

For this to work, everyone in the household must connect their OurGroceries app to the same OurGroceries account. Note that this account is not related to your Apple or Google account. This is a separate account that you have with us.

  • The account is identified using an email address. Choose a single email address for the household. It can belong to anyone in the household, but list sharing will only work if you use a single email address. If you enter two different email addresses in two members’ apps, they’ll be on different OurGroceries accounts and their lists won’t be shared.

To create an account, or to add someone to an account, run the OurGroceries app, go to Settings, find the “List sharing” screen, and type in the email address you’ve chosen to use. Be careful to type it in correctly. And remember that this must be done on everyone’s phone, including the person the email address belongs to.

Tap the “Send” button and we will send an email to the email address you’ve specified. We do this to verify that the owner approves of this phone having access to the lists in this account. Otherwise, anyone could enter your email address and see your lists. In the email you’ll find a link. Click the link to approve adding this device to your account.

Remember that if you add multiple devices, you’ll get multiple emails. You’ll need to click the link in every email.

Once you’ve clicked the link approving a device, the account’s lists will show up in OurGroceries on the device. If the device already had some lists, they will be merged into the shared account so that no data is lost.

To remove someone from your account, sign in to the website, go to the “Settings” link in the upper-right, and delete the device from your account. Learn more about using the website.

If you later change your email address, you can update your OurGroceries account to match. Learn more

If you find that your lists are not synchronized despite following the above instructions, contact us and we’ll help you out.

Using recipes

The focus of recipes in OurGroceries is on the ingredients, and particularly the ingredients you might need to buy at the store. You typically won’t enter ingredients like water, oil, and salt. Enter the ingredients into the recipe and edit the recipe’s notes to add the cooking instructions, links to the source of the recipe (if it came from a website), and other details. Learn more about notes

When you’ve decided to make a recipe, review the items. Tap the items that you’ll need to buy, and they’ll be added to your shopping list. The first time you do this, OurGroceries will ask you which shopping list each item should be added to. (It won’t ask if you only have one shopping list.) It’ll remember your choice for next time. This is to facilitate the case where you buy, for example, your bread from the grocery store but the meat from the butcher.

(If you tapped the wrong shopping list, or later change your mind about which shopping list an item should be put on, you can tap the to the right of the item name in the recipe then change the shopping list there. It’s called “Target list” on the iPhone and “Add item to” on Android.)

If you think you need all or most of the ingredients, you can add all of the ingredients at once to the various shopping lists to which they belong. To do this on iPhone, tap the button at the bottom of the screen labeled “Add recipe to shopping list”. To do this on Android, tap the menu button at the top right, then select “Add recipe to shopping list”.

Recipes can have other uses as well. For example, if you buy the same set of things every week, then you can create a “recipe” with these items and add them to your shopping list with one tap. You could also have a recipe of things you need to pack for an airplane trip, add them with one tap to a “Get ready” shopping list, then cross off items as you pack them.

Creating lists and recipes

To create a shopping list, go to the top-level screen (the one that shows all of your shopping lists and recipes) and tap the line labeled “Add a shopping list...” at the bottom of the list of shopping lists. Shopping lists must all have unique names. Typically shopping lists are named after various stores you shop at, but that’s entirely up to you, and some people create shopping lists for to-do tasks and other shared lists.

To create a recipe, go to the top-level screen (the one that shows all of your shopping lists and recipes) and tap the line labeled “Add a recipe...” at the bottom of the list of recipes. Recipes must all have unique names.

On the website, these are buttons above the list of shopping lists.

Deleting lists and recipes

To delete a shopping list or recipe:

  • On iPhone: Go to the top-level screen (the one that shows all of your shopping lists and recipes), tap the icon to the right of the shopping list or recipe you want to delete, then tap “Delete Shopping List” or “Delete Recipe”.
  • On Android: Visit the shopping list or recipe itself, tap the menu icon in the upper-right (looks like  ), then tap “Delete list” or “Delete recipe”.
  • On the website: Visit the shopping list or recipe itself, then click the “Delete List” or “Delete Recipe” button at the bottom of the page.
  • Note that deleting a shopping list or recipe cannot be undone. Once deleted, the list and the items in it cannot be recovered. (If the items are also in other lists, those are not deleted.)

If you accidentally deleted a shopping list, you can enable the “Add multiple items” setting to make it easier to reconstruct it. Learn more

Renaming lists and recipes

To rename a shopping list or recipe:

  • On iPhone: Go to the top-level screen (the one that shows all of your shopping lists and recipes), tap the icon to the right of the shopping list or recipe you want to rename, enter the new name, then tap “Done” on the keyboard.
  • On Android: Visit the shopping list or recipe itself, tap the menu icon in the upper-right (looks like  ), tap “Rename list” or “Rename recipe”, then enter the new name.
  • On the website: Visit the shopping list or recipe itself, then click the “Rename List” or “Rename Recipe” button at the bottom of the page.

Upgrading to turn off ads

The OurGroceries app is free, but we show ads in a few screens in order to help pay for continued development. If these ads bother you, or if you’d like to support development directly, you can upgrade. This does not require you to download another app or lose your lists.

  • Upgrading is not required in order to use most of OurGroceries, including all the basic features and list sharing. All premium-only features are clearly marked in this user manual with a heart icon like the one on the left. All other features are available free.

The price of upgrading depends on the country, but is about USD$5. It is a one-time payment.

Upgrading is done through the app store of your device (the App Store on iPhone, the Play Store on Android), and it handles all payment. It also keeps track of the fact that you’ve upgraded, so that you can upgrade again later free if you get a new phone. The upgrade is tied to that store account, however. Just because you share your OurGroceries lists with your partner does not mean that your upgrade will apply to them. We are not permitted to extend upgrades to all devices in the OurGroceries account.

Upgrading also unlocks a few premium-only features:

  • On both iPhone and Android you’ll be able to take photos of items, to make sure that your partner gets exactly what you want. Note that you don’t need upgrade to see the photos taken by your partner. Only the person taking the photo needs to upgrade. Learn more
  • On Android you’ll be able to scan the barcode of products to add them automatically to your list. Note that our database of product is rather U.S.-centric. We encourage you to try the barcode scanning first to make sure that your frequently-purchased items are in our database before upgrading. Learn more
  • If you have an Android Wear watch, you’ll be able to see your lists on your watch, tap items to cross them off, and add items with your voice. You can try this without upgrading, but you’ll be nagged to upgrade every time you use it. Learn more

If you’d like to upgrade:

  • To upgrade on iPhone, go to the top-level screen of OurGroceries, tap the Settings icon (), then tap “Turn Off Ads”. From this screen you can buy the upgrade. If you had previously bought the upgrade using this App Store account, then you can tap “Restore” to restore your upgrade. Note that Apple does not permit in-app purchases like this one to be shared using Apple Family Sharing.
  • To upgrade on Android, on any screen of OurGroceries tap the menu icon in the upper-right (looks like  ), tap “Settings”, tap “Turn Off Ads”, then tap “Upgrade”. You’ll be taken to the Play Store to purchase a separate app called “OurGroceries Key” (buy it now). This app is not a replacement for the main OurGroceries app. It has no interface, and you do not launch it yourself. Its presence on your phone causes the main OurGroceries app to be upgraded. Note that this app is eligible for sharing using Google Play Family Library.
  • There’s no direct way to upgrade the website version of OurGroceries, but if you upgrade the OurGroceries app on any mobile device (iPhone or Android) in your account, the website will be considered upgraded and will no longer show ads.

Categories

By default all new items are uncategorized. If you’d like you can assign items to categories, and they will by grouped by category in the shopping list. For example, if you assign “milk” and “cream” to the “Dairy” category, then both will show up together in the “Dairy” section of your shopping list. This can make shopping easier, since dairy items are often located near each other in the supermarket.

To put an item in a category, tap the icon to the right of the item name, then tap the “Category” chooser. We provide a few default categories, but you’re free to add your own or change the ones that already exist. You can edit the list of categories from the Settings screen of OurGroceries. You can also rearrange categories, so that the sections in the shopping list will be in the order that you visit the store. Learn more

Although the default category names are things like “Dairy” and “Produce”, some people use aisle numbers instead, like “Aisle 1” and “Aisle 2”. Remember, though, that categories are the same across all shopping lists. That means that (for example) “tomato soup” will be in “Aisle 4” for all lists, even though tomato soup may be in different aisles in different stores. Using aisles for categories works best if you do most of your shopping at the same store.

To make it easier to set categories for items, you can enable the setting called “Ask for category”. This will ask you to choose a category when you add an uncategorized item to your shopping list. Learn more

Changing item order

By default items are shown alphabetically in your shopping list. You can rearrange them to be in another order, for example to match the order that you visit the store. (You can accomplish the same thing using categories. Learn more.)

If you’d like to rearrange items:

  • On iPhone: While looking at a shopping list, tap the “Edit” button at the lower-right. Handles will show up at the right of the item names. These handles look like three horizontal gray lines. You can drag items by their handles. When finished, tap the “Done” button at the lower-right of the screen.
  • On Android: While looking at a shopping list, open the menu by tapping the menu button in the upper-right (looks like  ). From this menu select “Rearrange items”. Handles will show up at the left of the item names. These handles look like three horizontal lines. You can drag items by their handles. When finished, tap the left-facing arrow at the top-left of the screen.
  • On the website: While looking at a shopping list, move your mouse cursor to hover over the item you’d like to move. A handle (horizontal lines) will appear at the left of the item. Drag this handle to move the item to another position in the list.

Once you rearrange items, we remember this new order for the next time that you create a shopping list. If you’re using categories, you can also drag items to another category in order to categorize it differently.

  • One word of warning about rearranging items: Once you’ve rearranged a few items, we can no longer display the list fully alphabetically while still showing your re-arranged items in your preferred order. This can be a bit confusing, because a new item like “apple” may show up at the bottom of the list instead of at the top, where you might expect it alphabetically. If you’ve rearranged some items by accident and would like to revert to showing items only alphabetically, you can do so in our Settings screen. Learn more

List notes

Each shopping list and each recipe can have an attached note. For a shopping list the note might include the store’s address and other generic store information. For a recipe you could store the steps in the recipe and a web link to where you originally found it.

To edit a note:

  • On iPhone: While looking at a shopping list or recipe, tap the button centered at the bottom. It looks like a square with a pencil. You can then tap the “Edit” button in the upper-right to edit the note, then “Done” when finished.
  • On Android: While looking at a shopping list or recipe, open the menu in the upper right (looks like  ), then tap “View list notes” or “View recipe notes”. From there you can edit the note and tap “Save” when done.
  • On the website: The note is visible at the bottom of the shopping list or recipe. Click the “Edit Notes” button below it to edit the note, then tap “Save Notes” to save it.

Photos

  • Photos are a premium feature of OurGroceries. You must upgrade if you’d like to add a photo to an item. To see a photo that someone else has added does not require upgrading. Learn more about upgrading

You can add a photo to each item. This is useful if you want to be sure that your partner gets exactly the item you have in mind.

To add a photo:

  • On iPhone: Tap the icon to the right of the item name. On the displayed screen, tap the camera icon in the lower-left of the screen. You’re then have a choice of taking a photo with the camera or choosing a photo from your photo album. Select an option, then either take the photo or choose one. To remove a photo from an item, tap the “Remove Photo” button below the photo.
  • On Android: Tap the icon to the right of the item name. On the displayed screen, tap either the “Take Photo” button to take a new photo with the camera, or the “Choose Photo” button to choose a photo from your photo album. To remove a photo from an item, tap the “Remove Photo” button above the photo.
  • On the website: You cannot currently add a new photo on the website. To see an existing photo, click the icon to the right of the item name. To remove a photo from an item, click the “Remove photo” button above the photo.

Items that have photos will show a small thumbnail in the shopping list. You can tap that thumbnail to see the full-size version.

Barcode scanning

  • Barcode scanning is a premium feature of OurGroceries. Without upgrading, you can scan barcodes and find the name of the item, but it won’t be added to your shopping list. This is a good way to determine whether our barcode database has many of the items that you’d like to scan. Learn more about upgrading
  • Barcode scanning is currently only available in our Android app. We plan to add barcode scanning to our iPhone app sometime in 2017.

OurGroceries has a database of 17 million products and their barcodes (UPC). You can scan a barcode using your phone’s camera and OurGroceries will look it up in its database. If it’s found, the item’s name will be added to your shopping list.

To scan a barcode, go to the shopping list to which you’d like to add the item and tap the barcode icon at the top of the screen. This will take you to a separate app called “Barcode Scanner”. If you do not have this app installed on your device, you will be prompted to install it.

Aim your device’s camera at the product’s barcode. Once the barcode has been scanned, the scanning app will display the message “Product found”. This is a misleading message because it does not mean that our database has recognized the product. It only means that the numbers were read from the barcode.

If our database knows about the product, the name of the product will be read aloud and its name will be added to your list. You can disable this reading aloud in the “Settings” screen. Learn more

If the barcode is not in our database, you will see a message telling you that the barcode is unknown and giving you the option to add the item manually. If you tap “Add Manually”, you will be taken to the normal screen where you can type a new item’s name or choose one from the existing list. Once you type or select an item, it will be added to your shopping list and the scanned barcode will be associated with it. The next time you scan that barcode, that item will be added to your list directly. It won’t be looked up in our database.

If you’d like to remove a barcode from an item in your shopping list, tap the icon to the right of the item and tap the “Clear Barcode” button.

To associate a barcode with an existing item, tap the icon to the right of the item and tap the “Scan Barcode” button. You’ll be able to scan a barcode with your camera as described above and the barcode will be associated with that item. The next time you scan that barcode, that item will be added to your list directly. It won’t be looked up in our database.

Website

You can see and edit your lists on the OurGroceries website. Click the Your Lists tab at the top of this page. You will be asked to sign in to your account. Enter the same email address that you use to share lists amongst family members with the mobile app. The mobile app does not require a password, but the website does. The first time you try to sign in, click the “please create an account” link. OurGroceries will make up a random password and email it to you. Use that password to sign in on that same page.

If you don’t get an email from us, check your spam folder. If the email isn’t there either, contact us for help.

If you’ve forgotten your password, click “please make up a new one and email it to me”. We will make up a new password and email it to you.

Once you’ve signed in, you can see your lists and edit them much like you can in the mobile app.

The “Settings” link in the upper-right lets you manage your account:

  • You can change your password by entering your existing password and your new password (twice).
  • You can change various settings that affect how the website works. These mirror the same settings in the mobile app. See the specific section for each setting in this user manual.
  • You can export all of your data. Learn more
  • At the bottom of the page is a table of all the devices that you’ve ever added to our account. You can click the icon to remove that device from your account. This will create a new empty account for that device and copy all of your lists to that account. Any changes made to the lists on that device will stay on that device and no longer affect yours.

Amazon Alexa

If you own an Amazon Echo, or any Alexa-enabled device, you can ask it to add items to your OurGroceries shopping lists using your voice. To make this possible, follow these steps:

  1. You’ll need your OurGroceries master email address and password. If you don’t have a password, create one first.
  2. Launch the Alexa app on your mobile phone, open the menu on the left, tap “Skills”, then search for “OurGroceries”. Tap the “Enable” button to enable the skill.
  3. The Alexa app will ask for your OurGroceries master email address and password. This information will go straight to OurGroceries. Alexa will not know your password, and your information will be transmitted securely to us. Enter the information from step 1 and tap “Sign In”.

You can then speak phrases like:

  • “Alexa, ask OurGroceries to add milk.”
  • “Alexa, tell OurGroceries to add olive oil to Walmart.”
  • “Alexa, ask OurGroceries what are my lists.”
  • “Alexa, ask OurGroceries what is on the groceries list.”
  • “Alexa, ask OurGroceries if milk is on Safeway list.”
  • “Alexa, tell OurGroceries to remove milk from groceries.”

If there’s a shopping list you use the most, you can make it your default list:

  • “Alexa, tell OurGroceries to set my default list to Safeway.”
  • “Alexa, ask OurGroceries what is my default list.”

You can then omit the list name if you’re changing that list:

  • “Alexa, ask OurGroceries to add milk.”
  • “Alexa, tell OurGroceries to remove milk.”

If you’re having trouble adding items to OurGroceries using Alexa, then see this answer.

If there’s a request that the skill didn’t understand, please contact us and let us know what it was. We’d love to hear how our voice interface can be more useful to you.

To remove your Alexa device from your OurGroceries account, visit your Settings page, scroll down to find the list of devices on your account, find the one called “Amazon Alexa”, and click the icon to the right of it.

Google Home

If you own a Google Home, you can ask it to add items to your OurGroceries shopping lists using your voice. (Although Google Assistant is available on other devices, such as the Pixel phone, these kinds of actions are currently only available on the Google Home.) To make this possible, follow these steps:

  1. You’ll need your OurGroceries master email address and password. If you don’t have a password, create one first.
  2. Say to your Google Assistant device, “Ok Google, talk to OurGroceries.” You’ll be asked to link your OurGroceries account.
  3. Launch the Home app on your mobile phone. The Home app will ask for your OurGroceries master email address and password. This information will go straight to OurGroceries. Google will not know your password, and your information will be transmitted securely to us. Enter the information from step 1 and tap “Sign In”.

You can then speak phrases like:

  • “Ok Google, ask OurGroceries to add milk.”
  • “Ok Google, ask OurGroceries to add milk, eggs, and bread.”
  • “Ok Google, tell OurGroceries to add olive oil to Walmart.”
  • “Ok Google, ask OurGroceries what are my lists.”
  • “Ok Google, ask OurGroceries what is on the groceries list.”
  • “Ok Google, ask OurGroceries if milk is on Safeway list.”
  • “Ok Google, tell OurGroceries to remove milk from groceries.”

If there’s a shopping list you use the most, you can make it your default list:

  • “Ok Google, tell OurGroceries to set my default list to Safeway.”
  • “Ok Google, ask OurGroceries what is my default list.”

You can then omit the list name if you’re changing that list:

  • “Ok Google, ask OurGroceries to add milk.”
  • “Ok Google, tell OurGroceries to remove milk.”

If there’s a request that the skill didn’t understand, please contact us and let us know what it was. We’d love to hear how our voice interface can be more useful to you.

To remove your Google Assistant device from your OurGroceries account, visit your Settings page, scroll down to find the list of devices on your account, find the one called “Google”, and click the icon to the right of it.

Android Wear

  • Android Wear support is a premium feature of OurGroceries. You can use the OurGroceries Wear app normally for testing and evaluation, but the next time you use the OurGroceries app on your phone, you will be reminded to upgrade. Learn more about upgrading
  • The Android Wear app currently only works with Android phones.

You can see your lists on your Android Wear watch. If you have a Wear device, the OurGroceries app will be installed on it automatically and your lists will be visible on it. You can tap items to cross them off, and tap “Add an item...” to add an item by voice.

To check if OurGroceries on your phone is connected to your watch, go to the “About” screen. At the bottom it should say, “An Android Wear watch is connected.” Learn more about the “About” screen

Importing data

You can import data into an OurGroceries shopping list or recipe. To do this, sign in to the OurGroceries website, click the list or recipe, then click the “Import items” button. Learn more about the website

A window will pop up. You have two options. One is to type (or paste) a list of items into the large box at the top. Each item must be on its own line. For example:

    milk
    potatoes (3)
    chicken

Each item will be added to your list or recipe as if you had added it individually.

Instead of typing the list manually, you can upload a file from your computer. To do this, click the “Choose File” button at the bottom of the window and find the file you’d like to upload. The file should follow the same guidelines just described—a plain text file with one item per line.

If you’ve used the app Out of Milk in the past, you can export your lists from there and import them here. Not all of the data will be kept. For example, OurGroceries does not currently have notes for each item.

One more option is to download our CSV template, open it using a spreadsheet program like Excel, edit it, and import it into OurGroceries. This is a good way of specifying categories for each item. (“CSV” stands for Comma-Separate Value. It’s a popular format for exchanging spreadsheet-like documents. Be sure to save your Excel document in CSV format for import into OurGroceries, and be sure to not delete the first header row.)

Exporting data

You can export all of your data. This includes your shopping lists, recipes, the master list of all the items you’ve ever added, and the list of categories.

To export your data, visit the OurGroceries website, sign in, click the “Settings” link at the upper-right of the page, and find the “Export Data” button. Learn more about the website

The data is downloaded as a ZIP file that contains a README.txt file that explains the contents of the ZIP file, the data in Microsoft Excel format (XLSX), and the data in JSON format.

  • Currently this is an export-only feature—you cannot modify this data externally and re-import it back into your account.

Settings

Everyone does their grocery shopping differently, and the “Settings” screen lets you configure OurGroceries to match the way you shop. To reach the Settings screen:

  • On iPhone: If you’re looking at a shopping list or recipe, tap the back (left-facing arrow) button in the upper-left to reach the top-level list-of-lists. From there, tap the gears button in the upper-left of the screen.
  • On Android: From any screen, tap the menu icon in the upper-right (looks like  ), and select the last option, “Settings”.
  • On the website: Once signed in, click the “Settings” link in the upper-right of the page.

The rest of this user guide describes all of the available settings.

About OurGroceries

The “About” screen in “Settings” (available on the iPhone and Android version of OurGroceries, but not on the website) shows the OurGroceries app version number and convenient buttons for getting help and rating the app.

The screen also tells you how long it has been since the app was able to reach our server. The app uses our server to backup your data and to pass your changes on to other devices in your household. If your device can’t reach our server, then your changes won’t be visible to others, and others’ changes won’t be visible to you.

The app tries to contact the server every 20 seconds when the app is open on your phone. The “About” screen should say something like, “Last connection to the OurGroceries server was 7 seconds ago.” If the time is longer than 20 seconds, or if it says, “There has not been a connection to the OurGroceries server since this app was launched,” then you should check your Internet connection. Perhaps you are off-line, or you asked your device to not permit OurGroceries to contact the Internet. Check the phone’s own Settings app.

Turn off ads

The “Turn off ads” screen in “Settings” can be used to upgrade OurGroceries and turn off the ads. On iOS this screen has buttons for upgrading and restoring a previous upgrade. On Android this is the same screen as “About”, which provides a button for installing the “OurGroceries Key” app. Learn more about upgrading

There’s no equivalent screen on the website because ads on the website will automatically be turned off if any mobile app in the account has upgraded.

List sharing

The “List sharing” screen in “Settings” is used to set up sharing of lists with others. Here you enter the email address you’d like to use for your OurGroceries account. This is also a good screen to verify that you’re using the email address you expect, and that sharing has been set up properly. The screen will give you detailed instructions about how to proceed. Learn more about list sharing

Note that this screen is not available on the website, because just signing in to the website establishes which OurGroceries account you want to use.

Item categories

The “Item categories” screen in “Settings” lets you edit and rearrange the item categories.

  • On iPhone: To add a category, scroll down to the bottom of the list and tap “Add a category...” To rename a category, tap its name. To delete a category, tap the button at the left of the row. To rearrange a category, drag it by the bars at the right of the row.
  • On Android: To add a category, scroll down to the bottom of the list and tap “Add a category...” To rename or delete a category, tap the icon at the right of the row. To rearrange categories, tap the double arrows at the top-right of the screen, drag rows by their bars, then tap the left-facing arrow at the top-right.
  • On the website: To reach this screen, visit any shopping list, then click the “Manage categories” button above the list. To add a category, scroll down to the bottom of the list and tap “Add a category...” To rename or delete a category, click its name. To rearrange a category, hover over the row with your mouse and drag it by the bars that appear at the left.

Sort list of lists

The “Sort list of lists” options in “Settings” lets you control the order OurGroceries shows shopping lists in the top-level screen. The default is to list them alphabetically. This option lets you instead put all shopping lists with items at the top, and empty lists at the bottom. (Within these two groups they will be listed alphabetically.) This makes it easier to find lists that have items that need to be purchased.

Lock orientation

While shopping it can be frustrating to hold the phone and have the screen orientation swap between vertical and horizontal whenever the phone is tilted. This option lets you lock the screen orientation.

  • On iPhone: This option is called “Lock Orientation to Vertical”. It will force the screen to the vertical format while running OurGroceries.
  • On Android: This option is called “Lock screen orientation”. This will force the screen to the natural orientation of the device (vertical for phones, horizontal for tablets) while running OurGroceries.
  • This setting is not available on the website.

Sort shopping list items

The “Sort shopping list items” option in “Settings” gives you some control over the order that OurGroceries lists items in shopping lists.

By default, new items added to shopping lists are shown in alphabetical order. You can rearrange items in whatever order you’d like them to be. Learn more about changing item order

Once items have been rearranged, however, they stay in that fixed order. This can be cause some unexpected behavior. For example, let’s say that you add items “bacon”, “cream”, and “dates” to your list. You then rearrange the items to put “cream” first, then rearrange them again to put “cream” back between the other two items. This order will now be fixed. It happens to be alphabetical, but that, to OurGroceries, is just a coincidence.

If you then add “apple” to your list, OurGroceries doesn’t know that the most natural place is at the beginning. So it puts it at the end. In fact all new items will show up at the end, alphabetized. You will end up with two parts to your list: the first that has a fixed order, and a second that’s alphabetized.

Fixing the items this way may not be what you had intended. You may have used drag-and-drop not to reorder items, but to put them into different categories. When this happens, you can use this setting to force OurGroceries to always show items in alphabetical order. Note that when you enable this setting, drag-and-drop will still work, but you will only be able to use it to move items to different categories.

This setting is not yet available on the website. On the website, items are always ordered “By drag and drop”, meaning in the fixed order you specified when you reordered items.

Sort crossed-off items

The “Sort crossed-off items” option in “Settings” lets you control the order of crossed-off items in shopping lists. There are three options:

  • “Alphabetically” lists items in alphabetical order. This is useful if you use your list of crossed-off items as your source of items to add to your shopping list.
  • “Recently crossed-off at the bottom” puts items that were recently crossed off at the bottom of the list. This option is not particularly useful, but was our original default and is being kept for user who got used to it this way.
  • “Recently crossed-off at the top” puts items that were recently crossed off at the top of the list. This is the default option for this setting and turns your crossed-off list into a reverse chronological list of the items you’ve purchased. The main benefit of this is to be able to quickly find an item that was accidentally crossed off. It’ll be at the top, where you can tap it again to uncross it off.

Cross-off action

The “Cross-off section” option in “Settings” lets you control what action you need to take to cross an item off your shopping list. By default this is a simple tap. If you find that you too easily tap items while shopping, then you can use this option to require an action that’s less likely to be performed accidentally.

  • On iPhone: The alternative action is “Swipe”, which means swiping your finger horizontally across the item in either direction (left to right or right to left).
  • On Android: The alternative action is “Long press”, which means holding your finger on the item for half a second.
  • This setting is not available on the website.

Show keyboard

The “Show keyboard” option in “Settings” lets you control whether the virtual keyboard is shown automatically after tapping “Add an item...” to add an item to your shopping list. By default this option is enabled. You may wish to disable it if you rarely type items but instead prefer to choose them from your master list.

If you've disabled this option, you can force the keyboard to be shown by tapping the item name box at the top of the screen.

Arrange, sort, and group master list

The master list is the list of all the items you’ve ever added to any list in OurGroceries. It’s the list you see when you tap “Add an item...” to add an item to your shopping list. This option lets you control the order and grouping of these items in the “Add an item” screen.

By default, the master list is ordered so that the most frequently-added items are at the top of your list. This makes it easy to add these items next time you make a list. You might prefer, though, to order the list alphabetically, especially if you don’t like to tap the first few letters of the item name.

Also by default, the master list is shown as one single big list. You might prefer to show them grouped by category, so that, for example, all “Dairy” items show up together. This makes it easier to browse the master list, looking for items that you might need to get.

Note that if you group by category but sort by common items first, then each category will show its own common items at the top.

  • On iPhone: This setting is called “Arrange Master List”. Choosing this setting shows you a screen where you can pick your sort and grouping preference.

  • On Android: These are two separate settings, called “Sort master list” and “Group master list”.
  • On the website: Only the sort option is available. Grouping by category has not been implemented.

Add multiple items

The “Add multiple items” option in “Settings” lets you specify that you want to be able to add more than one item at a time to your shopping list. By default, when adding an item from the “Add an item” screen, tapping an item both adds it to your list and closes that screen, returning you to your shopping list. With this option enabled, the screen will not close. You’ll be able to tap other items.

This option, combined with the grouping of the master list into categories, makes it particularly easy to browse your master list and add the items that you’re running low on. Learn more about master list grouping

  • On the website this option is not in the “Settings” screen, it is on the “Add an item” pop-up window.

Say scanned items

  • This option is only available on Android.

After scanning an item’s barcode, the item’s name is spoke aloud, to make it easier to use the app without looking at the screen. You can use this option to turn off the speaking. Learn more about barcode scanning

Ask for category

The “Ask for category” option in “Settings” lets you control whether OurGroceries asks you for the category of uncategorized items. By default, when adding an uncategorized item to your shopping list, the item shows up in a section called “Uncategorized”. You can then set its category manually. Learn more about categories

If you enable this option, then OurGroceries will prompt you for the category of an item you’re adding, if it’s uncategorized. This saves you a step and streamlines the process of categorizing all of your items.

Capitalize items

The “Capitalize items” option in “Settings” lets you specify whether newly typed-in item should be capitalized or not. By default this option is off. If you type the word “cookie” when adding an item, it will show up as “cookie”. With this option enabled, the word will be capitalized to “Cookie”. Essentially this is like pressing the “Shift” key at the beginning of the item name.

Extend screen timeout

  • This option is only available on Android. It is always enabled on the iPhone.

The “Extend screen timeout” option in “Settings” lets you extend the normal short screen timeout. This option is turned on by default. With the option off, the screen will timeout (the phone will turn off) by itself after a short period, normally about one minute. This is fine for normal phone use, but at the grocery store it can be annoying to turn the phone back on between each item.

When this option is enabled on Android (and always on iPhone), the timeout is extended to ten minutes.

List row size

  • This option is only available on Android.

The “List row size” option in “Settings” lets you set the size of the font and row for items. The default is “Normal”. Set it to “Small” to fit more items on the screen, or to “Large” to see the items more clearly.

Theme

  • This option is only available on Android.

The “Theme” option in “Settings” lets you set the look of OurGroceries. The default is “Fresh”, which is a light theme (black text on white background) with some color elements. The “Light” theme is similar but without the color elements. The “Dark” theme is white text on a dark background.

If you would like us to add more themes to this list, please contact us and point us to other apps or websites whose look you like.

Contact us