Want to Enter List Items on Your Computer?
Got lots of items to import into Listomni? Want to type them on your computer or import them from a spreadsheet? Checkout our Listomni Platform Item Generator: More Information...
Manual & FAQ
This is essentially the same help section which is available in the Groceries app. It's divided into Seven Sections and one Appendix. You can also download the manual in PDF.1. Introduction
2. Quick Start
3. List View
4. Item Detail View
5. Settings
6. Grouping and Sorting
7. Miscellaneous
A. FAQ
If this doesn't answer your question, please don't hesitate to email us!
1. Introduction
Welcome to Groceries!
Thanks for purchasing Groceries, the Grocery List App for iPhone and iPod Touch!
If you have questions, problems, comments or recommendations, please contact us as follows:
1) Tap the "i" button to the right of the toolbar.
2) Tap the "Contact Support" item in the "Help" section.
3) Tap the email address.

If you have questions, problems, comments or recommendations, please contact us as follows:
1) Tap the "i" button to the right of the toolbar.
2) Tap the "Contact Support" item in the "Help" section.
3) Tap the email address.

Protecting your data!
We STRONGLY recommend that you periodically backup of your data! Although iTunes backs up your data every time you sync, restoring from an iTunes backup is no fun as it restores the entire device, and requires music to be resynced.
Groceries Backups are quick:
1) Tap the "i" button
2) Tap "Backup and Restore"
3) Tap "Email Backup file" (Or Backup to File)
4) Send the email backup to an email address that is accessible on your device, and where it won't accidentally get deleted!

Groceries Backups are quick:
1) Tap the "i" button
2) Tap "Backup and Restore"
3) Tap "Email Backup file" (Or Backup to File)
4) Send the email backup to an email address that is accessible on your device, and where it won't accidentally get deleted!

How to Use this Guide
The rest of the Introduction discusses the basic architecture of the app. Section two is the Quick Start Guide, which is very dense, but should get you up to speed quickly. If you're going to read anything, read the Quick Start.
The rest of the guide discusses how to perform individual functions in the app. It's meant as a searchable reference rather than bed time reading material. An FAQ section is also available at the bottom of the guide.
To search this Guide, Tap the Magnifying Glass at the top of the screen. (A) Then Type what you're looking for into the Search Window with appears (B)
If a specific button is associated with the function, it's included by the title as visual queue. (C)
Just Browsing? Use the Detail Navigation buttons (D) to browse between entries.
This guide can also be found on our website in the Support Section if you'd rather check it out on a large screen or print it out.

The rest of the guide discusses how to perform individual functions in the app. It's meant as a searchable reference rather than bed time reading material. An FAQ section is also available at the bottom of the guide.
To search this Guide, Tap the Magnifying Glass at the top of the screen. (A) Then Type what you're looking for into the Search Window with appears (B)
If a specific button is associated with the function, it's included by the title as visual queue. (C)
Just Browsing? Use the Detail Navigation buttons (D) to browse between entries.
This guide can also be found on our website in the Support Section if you'd rather check it out on a large screen or print it out.

Overview
Groceries has three main types of objects:
the List, Items, and Dictionaries.
The List holds items and is what you see when you first launch the app.
A List Item is something you need to purchase such as "Milk" or "Toothbrush."
The dictionary is used to remember things that you've entered into the app before, such as items that weren't in the default dictionary, new store, or new units. This includes entire items, and individual field values. Whenever there is a list that you can pick a value from (store list, unit list) , a dictionary is in use.

the List, Items, and Dictionaries.
The List holds items and is what you see when you first launch the app.
A List Item is something you need to purchase such as "Milk" or "Toothbrush."
The dictionary is used to remember things that you've entered into the app before, such as items that weren't in the default dictionary, new store, or new units. This includes entire items, and individual field values. Whenever there is a list that you can pick a value from (store list, unit list) , a dictionary is in use.

List Philosphies
There are three schools of thought on how best to maintain your list in the app:
Method One: Add items to the list as needed, check an item off when you fulfill it, then delete checked off items after that particular trip or activity. Cost totaling works best with this method, as Checked off items can be counted up so you can see how much you've spent so far.
Method Two: Add items as needed, delete them as you fulfill them. This is the cleanest method when you don't care about Cost totaling during the activity, and don't need the list as a mnemonic.
Method Three: Add all the items to the list you'll ever need. Check items off when you fulfill them. Uncheck them when you need them again, or before the activity. This method works best when you need a reminder list for a recurring activity, but it doesn't work as well with Cost Totaling, as items will be included in the total at inappropriate times.
In all cases, you only type a full item in once, as Groceries remembers what you've typed even if you've deleted the item. It will recommend the item if you start to type it again. We mention this, because many people opt for Method three in an attempt avoid retyping items, which we feel is the least valid reason to pick that method.

Method One: Add items to the list as needed, check an item off when you fulfill it, then delete checked off items after that particular trip or activity. Cost totaling works best with this method, as Checked off items can be counted up so you can see how much you've spent so far.
Method Two: Add items as needed, delete them as you fulfill them. This is the cleanest method when you don't care about Cost totaling during the activity, and don't need the list as a mnemonic.
Method Three: Add all the items to the list you'll ever need. Check items off when you fulfill them. Uncheck them when you need them again, or before the activity. This method works best when you need a reminder list for a recurring activity, but it doesn't work as well with Cost Totaling, as items will be included in the total at inappropriate times.
In all cases, you only type a full item in once, as Groceries remembers what you've typed even if you've deleted the item. It will recommend the item if you start to type it again. We mention this, because many people opt for Method three in an attempt avoid retyping items, which we feel is the least valid reason to pick that method.

2. Quick Start
List View
List View shows you an overview of the items that are on a particular list.
A) Tap the Title of the List to search for an item
B) Items are usually grouped together under a "Group Header" by common properties such as store, section, or category. Tap the Text in the Group Header to just see the items under that group. (This also reveals subsequent grouping in the view. )
C) Tap the left most button on the group header to hide all items in that group.
D) While not in edit mode, each item has status indicator to the left of it which when tapped toggles the item between checked and unchecked.
E) Swiping an item will ask if you want to delete the item.
F) By Default, while not in edit mode, tapping the item anywhere but the checked indicator will switch to Detail View which show all fields for the items, and lets you edit their values.

A) Tap the Title of the List to search for an item
B) Items are usually grouped together under a "Group Header" by common properties such as store, section, or category. Tap the Text in the Group Header to just see the items under that group. (This also reveals subsequent grouping in the view. )
C) Tap the left most button on the group header to hide all items in that group.
D) While not in edit mode, each item has status indicator to the left of it which when tapped toggles the item between checked and unchecked.
E) Swiping an item will ask if you want to delete the item.
F) By Default, while not in edit mode, tapping the item anywhere but the checked indicator will switch to Detail View which show all fields for the items, and lets you edit their values.

List View Toolbar
List View usually has a Toolbar at the top to perform various functions:
A) Tap the left-most button (Filter Button) to hide and unhide checked items.
B) Tap the Green Plus button to add new items to the list.
C) Tap the Purple Eye button to group or sort the items on your list differently.
D) Tap the Blue Action button to Uncheck All items, Email items, or Add items from the Dictionary.
E) The "i" button opens the settings screen which controls list behavior, cost totaling, how items look, and lets you add and remove Stores, Categories, Units, and other dictionary items.

A) Tap the left-most button (Filter Button) to hide and unhide checked items.
B) Tap the Green Plus button to add new items to the list.
C) Tap the Purple Eye button to group or sort the items on your list differently.
D) Tap the Blue Action button to Uncheck All items, Email items, or Add items from the Dictionary.
E) The "i" button opens the settings screen which controls list behavior, cost totaling, how items look, and lets you add and remove Stores, Categories, Units, and other dictionary items.

List View (Edit Mode)
When you tap the Edit button in List View, both items and the toolbar changes to allow different functions:
A) Tap the button to the left of the item to select or unselect it for deletion, editing or some other action.
B) Tap the Green "Edit Multiple" Button to set the value of an item field for all selected items.
C) Tap the Red Trash Can Button to delete all selected items.
D) Tap the Blue Action button to email just the selected items.
E) Tap the right-most button on the toolbar to select or unselect all visible items.
F) Tap the button on the right of the group header in order to reorder the groups.
G) Press and hold an item by the move handle to drag to a different group, or manually order the list.
H) By default you can also just tap the item to select or unselect it, though this behavior can be modified in Settings.

A) Tap the button to the left of the item to select or unselect it for deletion, editing or some other action.
B) Tap the Green "Edit Multiple" Button to set the value of an item field for all selected items.
C) Tap the Red Trash Can Button to delete all selected items.
D) Tap the Blue Action button to email just the selected items.
E) Tap the right-most button on the toolbar to select or unselect all visible items.
F) Tap the button on the right of the group header in order to reorder the groups.
G) Press and hold an item by the move handle to drag to a different group, or manually order the list.
H) By default you can also just tap the item to select or unselect it, though this behavior can be modified in Settings.

Item Detail Views (Add & Edit)
An Item Detail View appears whenever you tap the Green Plus Button in List View to add items, or when you tap on an item in List View to edit items.
A) The Add screen provides a Cancel Button, an Add Another Button (the plus button) and a Done Button.
B) The Edit Screen provides a Back Button, and Buttons to scroll between items.
Both Add and Edit Screens shows you all available fields for an item and their current values.
C) Tap a row to Edit the Value
D) A Value Editor will be displayed in the bottom half of the screen
E) Directly above the Editor is the Editor Toolbar. (Discussed Next)

A) The Add screen provides a Cancel Button, an Add Another Button (the plus button) and a Done Button.
B) The Edit Screen provides a Back Button, and Buttons to scroll between items.
Both Add and Edit Screens shows you all available fields for an item and their current values.
C) Tap a row to Edit the Value
D) A Value Editor will be displayed in the bottom half of the screen
E) Directly above the Editor is the Editor Toolbar. (Discussed Next)

Editor Toolbar Buttons
The Editor Toolbar appears whenever you are editing a value in the app. It allows you to:
A) Start Editing the previous or the next field.
B) Editor Buttons appear when more than one input method is available for a particular field. This is useful when you want to add a new value which is not in the pick list, or if you would prefer to type the first few letters of the value rather than scrolling through the list.
C) The Triangle Button stops editing.
Area D shows the correspondence between editor buttons and the type of editor. See the item Detail section for more discussion of the different editors.

A) Start Editing the previous or the next field.
B) Editor Buttons appear when more than one input method is available for a particular field. This is useful when you want to add a new value which is not in the pick list, or if you would prefer to type the first few letters of the value rather than scrolling through the list.
C) The Triangle Button stops editing.
Area D shows the correspondence between editor buttons and the type of editor. See the item Detail section for more discussion of the different editors.

Let's Get Going!
You should be ready to get going at this point. Here is our recommendation on how to proceed:
1) Add whatever stores you want and delete those that you don't by tapping the "i" button and then "Stores" on the Settings screen.
2) Build your list
3) Try it out at the store.

1) Add whatever stores you want and delete those that you don't by tapping the "i" button and then "Stores" on the Settings screen.
2) Build your list
3) Try it out at the store.

3. List View
Adding Items to a List
To add a new item to a list:
1) Tap the green + button while viewing the list to open the Add screen for the list.
2) Type the Item name.
3) Tap any other fields you want to set for the item (Store for example)
4) Tap the Done button to save the item, or the + button to save the item and enter another.
For more information On the Add item Screen see the Item Detail View section.
Any new values you type in will be saved to the dictionary by default, so the next time you add the item, you won't have to type the entire item.

1) Tap the green + button while viewing the list to open the Add screen for the list.
2) Type the Item name.
3) Tap any other fields you want to set for the item (Store for example)
4) Tap the Done button to save the item, or the + button to save the item and enter another.
For more information On the Add item Screen see the Item Detail View section.
Any new values you type in will be saved to the dictionary by default, so the next time you add the item, you won't have to type the entire item.

Adding from the Dictionary
Some people prefer to pick items out of the dictionary when creating a list rather than type anything at all. To build your list this way:
1) Tap the Blue Action Button.
2) Select Browse Dictionary.
3) Select the items you want to add to the list by tapping the items.
4) Tap Add.
Note this only works well for the Grocery List type initially as it's the only list that comes with a pre-populated dictionary.

1) Tap the Blue Action Button.
2) Select Browse Dictionary.
3) Select the items you want to add to the list by tapping the items.
4) Tap Add.
Note this only works well for the Grocery List type initially as it's the only list that comes with a pre-populated dictionary.

Deleting Items
1) Swipe the item left to right.
2)Then tap the delete confirmation.
OR:
1)Tap the Edit Button
2) Select the items you want to delete by tapping the round circle to the left of the item
3) Tap the Red Trash Can Button.

2)Then tap the delete confirmation.
OR:
1)Tap the Edit Button
2) Select the items you want to delete by tapping the round circle to the left of the item
3) Tap the Red Trash Can Button.

Checking and Unchecking
When not in Edit mode, the button to the left of an item Shows you if the item is Unchecked (A) or Checked (B).
Tap the Button to toggle the item to the other state.
Note that optionally Checked items also contain a line through them. You can disable this in Settings.

Tap the Button to toggle the item to the other state.
Note that optionally Checked items also contain a line through them. You can disable this in Settings.

Hiding Checked Items
The left most button on the toolbar is the Checked Filter Button.
Tapping this button toggles from showing all items (A) , to showing just unchecked items (B) , to showing only checked items (C), and then back to showing all items.
It also shows the number of items currently visible, and the total items on the list in a red badge.
The badge can be disabled on the Settings screen.

Tapping this button toggles from showing all items (A) , to showing just unchecked items (B) , to showing only checked items (C), and then back to showing all items.
It also shows the number of items currently visible, and the total items on the list in a red badge.
The badge can be disabled on the Settings screen.

Removing Checked Items
As you check off items, they're still on your list, even if they're not visible. You can uncheck them all to restart the list, or you can delete all the checked items if it was a onetime list
1) Tap the Blue Action Button.
2) Tap "Remove Checked Items."
3) Pick "Delete Checked Items" to remove the checked off items on the list or "Uncheck Items" to keep the items and uncheck them.

1) Tap the Blue Action Button.
2) Tap "Remove Checked Items."
3) Pick "Delete Checked Items" to remove the checked off items on the list or "Uncheck Items" to keep the items and uncheck them.

Group Filtering
You can use groups in order to filter a list:
To filter on a group
1) Tap on the text group header in List View.
To return to the full list,
2) Tap on the Button which appears at the top left of the window.
Filtering by a group is particularly useful when you only want to see items for a particular store in the grocery list.

To filter on a group
1) Tap on the text group header in List View.
To return to the full list,
2) Tap on the Button which appears at the top left of the window.
Filtering by a group is particularly useful when you only want to see items for a particular store in the grocery list.

Collapse and Expand a Groups
To collapse a group and hide the items under it:
1) Tap the Triangular Button on on the left of the group header.
To expand a collapsed group and show the items again:
2) Tap the button again.
You can also Press and Hold any Group expansion button and you will be prompted to expand or collapse all groups.

1) Tap the Triangular Button on on the left of the group header.
To expand a collapsed group and show the items again:
2) Tap the button again.
You can also Press and Hold any Group expansion button and you will be prompted to expand or collapse all groups.

Manually Organizing Items
If the current view you're using does not sort items automatically, then it's possible to order them manually:
1) Tap the edit button in list view.
2) Drag rows around by the handle which appears to the right of the item.
Note that if you drag an item to another Group, it will set the item's value for the grouping field.
Manual orderings are specific to the a particular view and list combination.

1) Tap the edit button in list view.
2) Drag rows around by the handle which appears to the right of the item.
Note that if you drag an item to another Group, it will set the item's value for the grouping field.
Manual orderings are specific to the a particular view and list combination.

Emailing Visible Items
To email the items on the list screen
1) Tap the Blue Action Button.
2) Tap "Email Visible Items"
3) Tap "Easily Readable" to just format the fields you see in the list view in the email. Alternately, tapping "Spreadsheet" formats all fields in the email text as one large table.
4) Enter where you want to the email the list.
5) Press Send.
A link which allows the receiver to import the items into another copy of Groceries is also included in the mail.
Note that hidden items are not sent.

1) Tap the Blue Action Button.
2) Tap "Email Visible Items"
3) Tap "Easily Readable" to just format the fields you see in the list view in the email. Alternately, tapping "Spreadsheet" formats all fields in the email text as one large table.
4) Enter where you want to the email the list.
5) Press Send.
A link which allows the receiver to import the items into another copy of Groceries is also included in the mail.
Note that hidden items are not sent.

Selecting Items
While in Edit Mode in List View, you can select multiple items for various operations.
To toggle an item's selection property
A) Tap the Circle Button to the left of the button. When it's red, the item is selected.
B) By Default you can actually tap anywhere on the row to select the item, however this is Settings dependent.
Alternately:
C) Tap the rightmost toolbar button to Select or Deselect all visible items.
Note that if you filter by a group, and select all items, you will only select the items in that group, which can be useful from time to time.

To toggle an item's selection property
A) Tap the Circle Button to the left of the button. When it's red, the item is selected.
B) By Default you can actually tap anywhere on the row to select the item, however this is Settings dependent.
Alternately:
C) Tap the rightmost toolbar button to Select or Deselect all visible items.
Note that if you filter by a group, and select all items, you will only select the items in that group, which can be useful from time to time.

Emailing Selected Items
You can email just a few items from a list as follows:
1) Tap Edit
2) Use the buttons to the left of items to select them.
3) Tap the Blue Action Button.
4) Tap Email Items.
5) Pick the type of email ("Spreadsheet" includes all fields in the the email, "Easily Readable" only includes fields you currently see in List View, and group headers, though all fields are included in the import link.)
6) Enter an email address
7) Tap Send
This will launch mail with the items formatted in the mail, and a reimport link which can be clicked on the target device to reimport the items into a Groceries or Listomni.

1) Tap Edit
2) Use the buttons to the left of items to select them.
3) Tap the Blue Action Button.
4) Tap Email Items.
5) Pick the type of email ("Spreadsheet" includes all fields in the the email, "Easily Readable" only includes fields you currently see in List View, and group headers, though all fields are included in the import link.)
6) Enter an email address
7) Tap Send
This will launch mail with the items formatted in the mail, and a reimport link which can be clicked on the target device to reimport the items into a Groceries or Listomni.

Editing Multiple Items
You can edit fields for more than one item at a time.
1) Tap Edit.
2) Select some items using the buttons to the left of items.
3) Tap the Green Edit button.
4) Tap the field you want to set the value for.
5) Set a Value for the Field.
6) Tap the Apply.
Note that the Green Edit Button is only enabled when at lease two items are selected.
You can select all visible items for editing by using the right most button on the toolbar (A)

1) Tap Edit.
2) Select some items using the buttons to the left of items.
3) Tap the Green Edit button.
4) Tap the field you want to set the value for.
5) Set a Value for the Field.
6) Tap the Apply.
Note that the Green Edit Button is only enabled when at lease two items are selected.
You can select all visible items for editing by using the right most button on the toolbar (A)

Searching for Items
To search for an item in a list:
1) Tap the magnifying glass after the list title.
2) Type what you're looking for. (Fields which are searchable depends on the current list type.)
You can interact with items in the search result just as you would when there isn't a search:
A) Delete them.
B) Check them off
C) Open the Item in Item Details
3) Tap the cancel button to clear the search and return to viewing all items on the list. Canceling also zooms to the first item in the list which matched your search criteria.

1) Tap the magnifying glass after the list title.
2) Type what you're looking for. (Fields which are searchable depends on the current list type.)
You can interact with items in the search result just as you would when there isn't a search:
A) Delete them.
B) Check them off
C) Open the Item in Item Details
3) Tap the cancel button to clear the search and return to viewing all items on the list. Canceling also zooms to the first item in the list which matched your search criteria.

4. Item Detail View
Item Details Overview
The Item Detail View lets you see all fields for an item, and to edit those fields' values.
To open an item in Item Details:
A) Tap the item in list view while not in edit mode.
B) If you've changed the default row tap behavior in Settings, then you may have to instead tap the Detail button to open an item in Item Details.
Once in Item Details View, you can use the arrows at the top right of the screen (C) to switch between items which were visible in list view.
D) The Toolbar in Item Details can be used to add new items without leaving detail mode, delete the current item, or to move or email the current item.
E) Occasionally fields will have a light gray arrow button next to them. Tap the button to perform a external action, such as Searching for the value in Google or Maps, dialing a phone number, or composing an email to an email address. The function is dependent on the field and list type.

To open an item in Item Details:
A) Tap the item in list view while not in edit mode.
B) If you've changed the default row tap behavior in Settings, then you may have to instead tap the Detail button to open an item in Item Details.
Once in Item Details View, you can use the arrows at the top right of the screen (C) to switch between items which were visible in list view.
D) The Toolbar in Item Details can be used to add new items without leaving detail mode, delete the current item, or to move or email the current item.
E) Occasionally fields will have a light gray arrow button next to them. Tap the button to perform a external action, such as Searching for the value in Google or Maps, dialing a phone number, or composing an email to an email address. The function is dependent on the field and list type.

Editing in Item Details
To Edit a field's value in item Details:
1) Tap the field
2) Use the Editor which pops up to set the field's value.
A) Tap the Next or Back button to edit the Next or previous field for this item.
B) Tap an Arrow at the top of the screen to edit the same field for the next or previous item.
C) If available, the grey X button next to a value lets you clear the value out.
D) Tap the Upside triangle button to stop editing and stay on the details screen.
The item is saved when you return to list view or view a different item.

1) Tap the field
2) Use the Editor which pops up to set the field's value.
A) Tap the Next or Back button to edit the Next or previous field for this item.
B) Tap an Arrow at the top of the screen to edit the same field for the next or previous item.
C) If available, the grey X button next to a value lets you clear the value out.
D) Tap the Upside triangle button to stop editing and stay on the details screen.
The item is saved when you return to list view or view a different item.

Item Dictionary Fields
The First Field in Item Details View is the Item Dictionary Field.
1) As you start to Type, the Item Dictionary Field will recommend items from the Item dictionary which match what you've types so far.
2) Tap an Item in the recommended list to accept it and to autofill any dictionary fields such as Category, Section or Cost (C) which were saved in the dictionary. (See List Types for more information about which fields are copied into the Dictionary when items are saved. )
A) You can also tap the Browse Dictionary button to open the item Dictionary in full screen mode.
B) Tapping an item in the Browse Dictionary window accepts it and autofills any associated dictionary fields.

1) As you start to Type, the Item Dictionary Field will recommend items from the Item dictionary which match what you've types so far.
2) Tap an Item in the recommended list to accept it and to autofill any dictionary fields such as Category, Section or Cost (C) which were saved in the dictionary. (See List Types for more information about which fields are copied into the Dictionary when items are saved. )
A) You can also tap the Browse Dictionary button to open the item Dictionary in full screen mode.
B) Tapping an item in the Browse Dictionary window accepts it and autofills any associated dictionary fields.

Other Dictionary Fields
When entering or editing an item in Item Detail Views, the Store and Store Section fields are linked with a Dictionary behind the scenes. For all dictionaries other than the Item dictionary, you have the option of:
A) Picking a Value from the list.
B) Typing the Value (This will search the list of possible values or let you type a new value which wasn't in the dictionary yet.)
C) Browsing the Dictionary in full screen mode.
1) Tapping an item in the Browse Dictionary window picks the value
2) You can tap the Green Plus Button to add a new item to the dictionary (such as a store or category.)
3) You can delete items you don't want in the list.

A) Picking a Value from the list.
B) Typing the Value (This will search the list of possible values or let you type a new value which wasn't in the dictionary yet.)
C) Browsing the Dictionary in full screen mode.
1) Tapping an item in the Browse Dictionary window picks the value
2) You can tap the Green Plus Button to add a new item to the dictionary (such as a store or category.)
3) You can delete items you don't want in the list.

Quantity Field
The Grocery List's Quantity field lets you specify the Quantity and the Unit in two ways:
A) Type the Quantity and Pick the Unit.
B) Pick both the Quantity and Unit from the list.

A) Type the Quantity and Pick the Unit.
B) Pick both the Quantity and Unit from the list.

Comment Field
The Comment Field expands based on the amount of text which is entered into it (A). It can be used for whatever extra information there wasn't a field for.
The Comment field additionally attempts to Auto Detect Phone numbers (B), Email addresses(C), and URLs (D) for it's external action which lets you quickly jump to the phone app, the mail app or Safari.
The value must be the only content of the comment field for this detection to work properly. If no value can be detected, then the option to search for the entire comment field contents in a search engine is given (E).

The Comment field additionally attempts to Auto Detect Phone numbers (B), Email addresses(C), and URLs (D) for it's external action which lets you quickly jump to the phone app, the mail app or Safari.
The value must be the only content of the comment field for this detection to work properly. If no value can be detected, then the option to search for the entire comment field contents in a search engine is given (E).

Flags
The Flags field consolidates several Yes No flags for an item such as Checked / Not Checked, Important / Not Important, Have Coupon / No Coupon, On Sale/Not On Sale
A) Tap on a Flag button to toggle the flag.
B) For an explanation of each Flag button tap anywhere on the field except for a button.
C) Flags can be used to change the color of the item in Item Details, and in List View. More information can be found on this under the List Options, Item Layout and Colors.

A) Tap on a Flag button to toggle the flag.
B) For an explanation of each Flag button tap anywhere on the field except for a button.
C) Flags can be used to change the color of the item in Item Details, and in List View. More information can be found on this under the List Options, Item Layout and Colors.

Price Fields
Number Fields such as Prices and Tax may be entered in two ways:
A) Users can type in the number, specifying when the decimal occurs, and up to four decimal places.
B) ATM machine style number entry. Using this method, numbers have a fixed precision.
Additionally, Method A Provides a simple calculator via button (C) which lets you compute prices and other numbers when they're advertised in packs like 7 for $7.99 or 2 for one.

A) Users can type in the number, specifying when the decimal occurs, and up to four decimal places.
B) ATM machine style number entry. Using this method, numbers have a fixed precision.
Additionally, Method A Provides a simple calculator via button (C) which lets you compute prices and other numbers when they're advertised in packs like 7 for $7.99 or 2 for one.

Calculated Fields
Some item fields are related by a calculation. For example, setting the quantity(A) and a Unit price(B) for an item on the Grocery list, will automatically calculate the subtotal and the full price of the item (C).
Editing the full price of the item will reverse the calculation for the other fields which participate.
Look at the List Types appendix for a description of calculated fields.

Editing the full price of the item will reverse the calculation for the other fields which participate.
Look at the List Types appendix for a description of calculated fields.

Scheduling Repeating Items
You can Schedule an item to be added to the list in the future, or on a recurring basis.
1) Tap the Schedule field when Entering a new item or when Editing an existing one.
2) Select the type of schedule, how often it repeats, and the End Date ( if applicable.)
A) The Occurs Section will show you when the item will first be added to the list, when it was last added, and when it will next be added.
B) The Action section allows you to specify the behavior if a duplicate item is already on the list when the schedule runs.
Once you've scheduled an item, it's added to the list of Scheduled Items in the Settings Screen. You can delete or check the item off the list like you normally would without deleting the schedule. When the schedule runs, the item will be added to the list again, or unchecked if it's already present. Also see the "Scheduled Items" section in "Settings" to change how updates, deletes, and alerts relating to scheduled items are handled.

1) Tap the Schedule field when Entering a new item or when Editing an existing one.
2) Select the type of schedule, how often it repeats, and the End Date ( if applicable.)
A) The Occurs Section will show you when the item will first be added to the list, when it was last added, and when it will next be added.
B) The Action section allows you to specify the behavior if a duplicate item is already on the list when the schedule runs.
Once you've scheduled an item, it's added to the list of Scheduled Items in the Settings Screen. You can delete or check the item off the list like you normally would without deleting the schedule. When the schedule runs, the item will be added to the list again, or unchecked if it's already present. Also see the "Scheduled Items" section in "Settings" to change how updates, deletes, and alerts relating to scheduled items are handled.

5. Settings
The Settings Screen
A) The Settings screen lets you add stores, sections, and units, modify the rotation behavior and timeout behavior of the screen, if items are counted and displayed on the iPhone Home screen. Additionally, the List Title, Price Prompting, the Budget for the list, and how to count items on the list.
To access the Settings Screen while viewing the list:
1) Tap the "i" button.

To access the Settings Screen while viewing the list:
1) Tap the "i" button.

Backing Up Data
To create a backup of all you lists, and dictionaries:
1) Tap on the "i" button
2) Tap "Backup and Restore" Item
To Email the Backup to yourself
A)Tap "Email Backup File"
4)Tap "Send" after filling in the email form information
To instead save the backup file for transfer to your computer:
B) Tap "Save File Backup"
4) Connect your device to your Computer, Launch iTunes, and click on the device in the left hand window.
5) Click on the "Apps Tab"
6) At the bottom of the right hand window in the "File Sharing" section, click "Groceries"
7) Select the Backup File with the correct Date and drag it to a safe location. (The backup will also remain on your phone unless you delete it, but it's safest to store it separately on your computer in case the Application is accidentally deleted.
Note that on iPhone OS 3.1 and earlier, file attachments are not supported. Instead the backup is encoded in a link. These link can be truncated by Outlook and other mail programs if forwarded. Use the "Recoverable Backup" option (iPhone OS 3.1 Only) to ensure you can reconstruct the backup later. If you have problems with a backup, please contact support@ontomni.com

1) Tap on the "i" button
2) Tap "Backup and Restore" Item
To Email the Backup to yourself
A)Tap "Email Backup File"
4)Tap "Send" after filling in the email form information
To instead save the backup file for transfer to your computer:
B) Tap "Save File Backup"
4) Connect your device to your Computer, Launch iTunes, and click on the device in the left hand window.
5) Click on the "Apps Tab"
6) At the bottom of the right hand window in the "File Sharing" section, click "Groceries"
7) Select the Backup File with the correct Date and drag it to a safe location. (The backup will also remain on your phone unless you delete it, but it's safest to store it separately on your computer in case the Application is accidentally deleted.
Note that on iPhone OS 3.1 and earlier, file attachments are not supported. Instead the backup is encoded in a link. These link can be truncated by Outlook and other mail programs if forwarded. Use the "Recoverable Backup" option (iPhone OS 3.1 Only) to ensure you can reconstruct the backup later. If you have problems with a backup, please contact support@ontomni.com

Configuring Stores and Categories
You can add and remove Stores, Categories, Units, and other dictionary objects for the list by:
1) Tapping the "i" button while viewing the list to access the Settings screen.
2) Tap the Dictionary you want to add or remove values to in the Item Entry Section.
A) Tap The Green Plus Button to Add an Item.
B) Swipe the Item and tap Delete to delete an Item.

1) Tapping the "i" button while viewing the list to access the Settings screen.
2) Tap the Dictionary you want to add or remove values to in the Item Entry Section.
A) Tap The Green Plus Button to Add an Item.
B) Swipe the Item and tap Delete to delete an Item.

Customizing Auto Add Behavior
By Default, Groceries adds new values you type to the dictionary.
To change disable this behavior navigate to the List.
1) Tap the i Button to show the Settings Screen.
2) Tap the Dictionary you want to change the behavior for.
3) Tap the "i" Button for the Dictionary
4) Tap the Mode row and set the desired value.

To change disable this behavior navigate to the List.
1) Tap the i Button to show the Settings Screen.
2) Tap the Dictionary you want to change the behavior for.
3) Tap the "i" Button for the Dictionary
4) Tap the Mode row and set the desired value.

Locking Interface Orientation
You can prevent the interface from rotating when you turn the phone by setting the "Screen Rotation" mode to "Lock Portrait" on the Settings screen.
1) Tap the "i" button to open the Settings screen
2) "Screen Rotation under the "Screen Settings" Section. Auto is the default behavior.
Note that currently, you must rotate the device to the desired orientation once after setting this value before the lock will stick.

1) Tap the "i" button to open the Settings screen
2) "Screen Rotation under the "Screen Settings" Section. Auto is the default behavior.
Note that currently, you must rotate the device to the desired orientation once after setting this value before the lock will stick.

Disabling Screen Timeout
Normally, the Device will time out and Autolock itself when not touched for some time. (A) This can be annoying when shopping when you keep having to unlock the phone.
You can disable the screen from autolocking while you're using the app as follows:
1) Tap the "i" button to open the Settings Screen
2) Tap the "Screen Timeout" Item.
3) Select Disable.

You can disable the screen from autolocking while you're using the app as follows:
1) Tap the "i" button to open the Settings Screen
2) Tap the "Screen Timeout" Item.
3) Select Disable.

List Badge Count
You can change the Number badge which appears on the iPhone home screen over Groceries icon. (A)
It can be set to display the total number of items on the list, the number of unchecked items on the list, or it can be hidden altogether by selecting "None."
1) Tap on the "i" button to show the Settings screen.
2) Tap the App Icon Badge row
3) Set the desired behavior.

It can be set to display the total number of items on the list, the number of unchecked items on the list, or it can be hidden altogether by selecting "None."
1) Tap on the "i" button to show the Settings screen.
2) Tap the App Icon Badge row
3) Set the desired behavior.

Hiding Toolbar Counts
By Default the Filter Button(A) on the toolbar shows you how many items are on the list, how many are visible, and how many are hidden. To disable this numeric readout:
1) Tap the "i" button to open the Settings Screen.
2) Set the On Off switch to Off for the row "Filter Badge"

1) Tap the "i" button to open the Settings Screen.
2) Set the On Off switch to Off for the row "Filter Badge"

Numbers and Budgeting
You to total the cost of items on your list after tax and subtract this amount from a budget for the list. This information is displayed in the List View header. (A) Costs are also totaled by group. (B)
The Settings screen displays a Numbers and Budgeting section which controls settings related to the budgeting features of the app.
To turn totaling on or off, and modify the settings:
1) Tap the "i" Button to access the Settings screen.
2) Scroll down to the Numbers & Budgeting and tap the setting you want to change. Settings are covered in more depth in the next screens.

The Settings screen displays a Numbers and Budgeting section which controls settings related to the budgeting features of the app.
To turn totaling on or off, and modify the settings:
1) Tap the "i" Button to access the Settings screen.
2) Scroll down to the Numbers & Budgeting and tap the setting you want to change. Settings are covered in more depth in the next screens.

Cost Totaling
The list's Cost Totaling setting controls how the total value of the list is computed which is displayed on the List's Header. You can change this behavior:
1) Tap the "i" Button while viewing the list.
2) Tap the "Cost Totaling" row in the "Numbers & Budgeting Section.
You can choose from the following ways to calulate the total value of a list:
A) Don't Total. (Hides the price total from the Lists header. This also disables several other number related List Options.)
B) Checked items (Count only the items on the list which were checked off already, but not deleted. This corresponds to totaling items in the shopping cart or ready to purchase)
C) Unchecked items (Only items that have not been checked off the list. This equates to the value of items left to purchase.
D) All Items in the list. (Include to the Total for every item on the list.)

1) Tap the "i" Button while viewing the list.
2) Tap the "Cost Totaling" row in the "Numbers & Budgeting Section.
You can choose from the following ways to calulate the total value of a list:
A) Don't Total. (Hides the price total from the Lists header. This also disables several other number related List Options.)
B) Checked items (Count only the items on the list which were checked off already, but not deleted. This corresponds to totaling items in the shopping cart or ready to purchase)
C) Unchecked items (Only items that have not been checked off the list. This equates to the value of items left to purchase.
D) All Items in the list. (Include to the Total for every item on the list.)

List Budget
To Set the budget for the list:
1) Tap the "i" button while viewing the list to show the Settings screen.
2) Tap the List Budget row in the Numbers & Budgeting section.
3) Enter a value.
A) The total cost of items on the list, according to the Cost Totaling method will be subtracted from this budget and displayed in the list header.
B) If no budget is set, the only the total amount on the list is shown.
Cost Totaling must be set to a value other than "Don't Total" to set a budget for the list.

1) Tap the "i" button while viewing the list to show the Settings screen.
2) Tap the List Budget row in the Numbers & Budgeting section.
3) Enter a value.
A) The total cost of items on the list, according to the Cost Totaling method will be subtracted from this budget and displayed in the list header.
B) If no budget is set, the only the total amount on the list is shown.
Cost Totaling must be set to a value other than "Don't Total" to set a budget for the list.

Check Off Prompt
Depending on the list's "Check Off Prompt" (A) mode, the budgeting feature will insist you enter cost information for items before you can check them off the list (B). You can have the app never prompt you, always prompt you, or only prompt you when the cost is missing.
When this option is enabled for the List, the "Prompt Fields" (C) can also be set, which controls which fields are displayed and editable in the Prompt.

When this option is enabled for the List, the "Prompt Fields" (C) can also be set, which controls which fields are displayed and editable in the Prompt.

Currency Format
By Default, all cost fields are displayed according to the region setting on the device. You can override this while on traveling to other countries when you might want to total costs in a foreign currency.
1) Tap the "i" button to show the Settings screen.
2) In the Numbers and Budgeting section, tap the "Currency Format" row.
3) Pick a currency format.
Note that this does not recompute values in the list, it simply changes how the price is formatted.

1) Tap the "i" button to show the Settings screen.
2) In the Numbers and Budgeting section, tap the "Currency Format" row.
3) Pick a currency format.
Note that this does not recompute values in the list, it simply changes how the price is formatted.

Appearance Settings
The settings screen also allows you to change several items which are related to how items are displayed in List View
A) The list title which appears on the list header.
B) Cross Off Items - When enabled checked off items on lists also have a line strike through them, otherwise they're just grayed out.
C) Shrink List Text to Fit - In List View fields shrink significantly to fit as much text on each row as possible. This can be disabled by toggling the On Off switch for this setting, as it can be distracting for lists which have lots of moderate length strings.

A) The list title which appears on the list header.
B) Cross Off Items - When enabled checked off items on lists also have a line strike through them, otherwise they're just grayed out.
C) Shrink List Text to Fit - In List View fields shrink significantly to fit as much text on each row as possible. This can be disabled by toggling the On Off switch for this setting, as it can be distracting for lists which have lots of moderate length strings.

Item Layout and Colors
Also under the Appearance section of the settings screen are Item Layout and Color settings for the app.
An "Item Layout" controls :
A) Which item fields are displayed in list view, and if there are only two fields displayed, if items are reduced in height.
B) If the checkoff button is visible
C) The default row, list, and button color. An Item layout also controls under what conditions a row or check off button will change color. (Such as Overdue, high priority, etc. etc. )
Groceries comes with two different Item Layouts by default, the standard and a condensed row layout.
To change the default item layout for the list:
1) Tap the "i" button on the list to open List Options.
2) Find and Tap on the "Item Layout and Colors" Row in the "Appearance" section.
3) Tap on the desired Item Layout from the list and exit back to the list.
(Each Layout offers a representation of what it will look like, and also will animate the color's it each row may take on depending on different item field values. )

An "Item Layout" controls :
A) Which item fields are displayed in list view, and if there are only two fields displayed, if items are reduced in height.
B) If the checkoff button is visible
C) The default row, list, and button color. An Item layout also controls under what conditions a row or check off button will change color. (Such as Overdue, high priority, etc. etc. )
Groceries comes with two different Item Layouts by default, the standard and a condensed row layout.
To change the default item layout for the list:
1) Tap the "i" button on the list to open List Options.
2) Find and Tap on the "Item Layout and Colors" Row in the "Appearance" section.
3) Tap on the desired Item Layout from the list and exit back to the list.
(Each Layout offers a representation of what it will look like, and also will animate the color's it each row may take on depending on different item field values. )

Customizing Item Layouts
If there isn't a default Item Layout which suits your needs you can create a new Item Layout and specify which fields appear, if the check off button is hidden, and the color rules which affect the item.
From List View:
1) Tap the "i" Button.
2) Tap "Item Layout and Colors"
3) Tap Edit.
4) Tap the "Tap To Add Layout" row to create a new layout or tap an existing the Layout you'd like to modify.
A) A sample row is displayed at the top, so you can see how your changes will affect what each item will look like in List View.
B)Set each of four cell positions to show a different item field.
C) If you leave the Lower field positions blank, then you also have the option of Shrinking the Over All cell height to fit more items on the screen in list view.
Row color schemes are discussed on the next Help Item.

From List View:
1) Tap the "i" Button.
2) Tap "Item Layout and Colors"
3) Tap Edit.
4) Tap the "Tap To Add Layout" row to create a new layout or tap an existing the Layout you'd like to modify.
A) A sample row is displayed at the top, so you can see how your changes will affect what each item will look like in List View.
B)Set each of four cell positions to show a different item field.
C) If you leave the Lower field positions blank, then you also have the option of Shrinking the Over All cell height to fit more items on the screen in list view.
Row color schemes are discussed on the next Help Item.

Customizing Item Colors
An Item Layout also controls:
A) If the Toggle Button Appears and the Default Button Color
B) If the Toggle button changes color based on an item field: (Have Coupon, Checked, On Sale).
C) The List Row color. (This also changes the color of the list on the List Tab)
D) If the Row changes color based on an item field.

A) If the Toggle Button Appears and the Default Button Color
B) If the Toggle button changes color based on an item field: (Have Coupon, Checked, On Sale).
C) The List Row color. (This also changes the color of the list on the List Tab)
D) If the Row changes color based on an item field.

Row Tap Behavior
By Default, while viewing a list, tapping an item opens it in Item Detail View (A).
This behavior can be modified to do nothing, or to Toggle the item's checked flag instead (B) .
The latter two settings also causes an Item Detail button to appear on each item which will open Item Details if tapped. (C))
To Change this setting on the Settings screen:
1) Tap the "Row Tap" row under "Row Tap Behavior" and Select a new Value.

This behavior can be modified to do nothing, or to Toggle the item's checked flag instead (B) .
The latter two settings also causes an Item Detail button to appear on each item which will open Item Details if tapped. (C))
To Change this setting on the Settings screen:
1) Tap the "Row Tap" row under "Row Tap Behavior" and Select a new Value.

Edit Row Tap Behavior
By Default, while in edit mode on list, tapping an item toggles the item selection flag (A)
This behavior can be modified to open the item in Item Details(B), or to Edit the Item in Place(C), or to not perform any action.
The latter setting also causes an Item Detail button to appear on each item in this mode.
To Change this setting on the Settings screen:
1) Tap the "Edit Row Tap" row under "Row Tap Behavior" and Select a new Value.

This behavior can be modified to open the item in Item Details(B), or to Edit the Item in Place(C), or to not perform any action.
The latter setting also causes an Item Detail button to appear on each item in this mode.
To Change this setting on the Settings screen:
1) Tap the "Edit Row Tap" row under "Row Tap Behavior" and Select a new Value.

Item Entry Settings
Also on the Settings Screen are controls which impact the apps behavior when typing text:
A) The Auto-Correction row in the Settings Tab controls whether or not Groceries uses the device's keyboard correction.
B) The "Auto-Caps Mode" row in the Settings Tab controls when the iPhone keyboard automatically selects the "Shift" key on the iPhone Keyboard.
The options are Title Case, Sentence Case, or No Auto Capitalization. This setting only impacts text fields other than the comment fields.
C) The "Duplicate Items" row controls application behavior when you add an item to the list which is already present. By Default, this prompts you to ask how to deal with the duplicates. Other possibilities are: "Merge / Uncheck", "Add Duplicates" and "Replace Existing"

A) The Auto-Correction row in the Settings Tab controls whether or not Groceries uses the device's keyboard correction.
B) The "Auto-Caps Mode" row in the Settings Tab controls when the iPhone keyboard automatically selects the "Shift" key on the iPhone Keyboard.
The options are Title Case, Sentence Case, or No Auto Capitalization. This setting only impacts text fields other than the comment fields.
C) The "Duplicate Items" row controls application behavior when you add an item to the list which is already present. By Default, this prompts you to ask how to deal with the duplicates. Other possibilities are: "Merge / Uncheck", "Add Duplicates" and "Replace Existing"

Default Field Values
When adding new items to the list, you can set the default values which are used for certain fields.
1) Open the List Options screen by tapping the "i" button on the list.
2) Tap the Item Default row at the bottom of the Item Entry section.
3) Tap the field you want to change the default value for.
You can set a fixed value, or set it to always use the last value entered for the field.
This is useful for setting a Default Tax Rate for a list.

1) Open the List Options screen by tapping the "i" button on the list.
2) Tap the Item Default row at the bottom of the Item Entry section.
3) Tap the field you want to change the default value for.
You can set a fixed value, or set it to always use the last value entered for the field.
This is useful for setting a Default Tax Rate for a list.

Currently Scheduled Items
The Scheduled Items row in List Options lets you see, add to, delete, or modify all the Items which are scheduled to be added to the list at some time in the future, regardless of if they have an instance on the list at that time.
1) Tap the "i" Button to open the Settings screen
2) Tap "Scheduled Items" in the Scheduled Items section.
Tap the Blue Detail button to edit a scheduled item.
Tap the Green Plus button to add a new scheduled item.
Select an item and tap the Red Trashcan to delete the item.
Look here to get rid of scheduled items when you're done with them, even if they're not on your list at the moment.

1) Tap the "i" Button to open the Settings screen
2) Tap "Scheduled Items" in the Scheduled Items section.
Tap the Blue Detail button to edit a scheduled item.
Tap the Green Plus button to add a new scheduled item.
Select an item and tap the Red Trashcan to delete the item.
Look here to get rid of scheduled items when you're done with them, even if they're not on your list at the moment.

Scheduled Item Settings
Additional Settings which control the behavior of items you schedule are pictured below:
A) "Alert When Adding Items" row specifies if an alert is displayed whenever the scheduler adds a recurring item to the list, or updates one on the list. This can be used as an impromptu notification
B) "On Item Delete" Lets you specify what happens to an Item Schedule when you delete an item with that schedule from the list. you can instruct the app "Don't Delete the Schedule", " Delete the Schedule", or "Ask Me" Deleting the schedule will stop the item from appearing.
C) "On Item Edit" Lets you specify what happens to an Item Schedule when you edit an item with that schedule from the list. You can instruct the app "Update the Schedule", "Don't Update the Schedule", or "Ask Me." This controls if future items added to the list reflect your changes.

A) "Alert When Adding Items" row specifies if an alert is displayed whenever the scheduler adds a recurring item to the list, or updates one on the list. This can be used as an impromptu notification
B) "On Item Delete" Lets you specify what happens to an Item Schedule when you delete an item with that schedule from the list. you can instruct the app "Don't Delete the Schedule", " Delete the Schedule", or "Ask Me" Deleting the schedule will stop the item from appearing.
C) "On Item Edit" Lets you specify what happens to an Item Schedule when you edit an item with that schedule from the list. You can instruct the app "Update the Schedule", "Don't Update the Schedule", or "Ask Me." This controls if future items added to the list reflect your changes.

6. Grouping and Sorting
Changing Views
Groceries comes with several built in ways to group and order items on your list. These are called views. Views can also override the list's default layout of fields and the color rules for items.
To change between views:
1) Tap the purple Sorting and Grouping button.
2) Tap the view you want to use.
Note that you can modify the views (say...to sort alphabetically, or group by a different property) if the standard views don't do quite what you want.

To change between views:
1) Tap the purple Sorting and Grouping button.
2) Tap the view you want to use.
Note that you can modify the views (say...to sort alphabetically, or group by a different property) if the standard views don't do quite what you want.

Ordering Groups and Sections
To reorder grouping sections from List View:
1) Tap Edit.
2) Tap any round reorder handle on the right hand side of any Group Header.
A) The first area lets you setup sorting behavior for the group sections based on a dictionary view, the section's natural order (alphabetic or chronological), and specify where items that don't have a value set for the grouping field end up.
B) The second area shows you how the Groups will be ordered.
C) To manually order the group headers at any time Press and Drag the rows to the order you want using the reorder handles on the right.
Note that this Ordering is specific to the current view, so if you create additional views, it is possible to order things like sections differently.

1) Tap Edit.
2) Tap any round reorder handle on the right hand side of any Group Header.
A) The first area lets you setup sorting behavior for the group sections based on a dictionary view, the section's natural order (alphabetic or chronological), and specify where items that don't have a value set for the grouping field end up.
B) The second area shows you how the Groups will be ordered.
C) To manually order the group headers at any time Press and Drag the rows to the order you want using the reorder handles on the right.
Note that this Ordering is specific to the current view, so if you create additional views, it is possible to order things like sections differently.

Managing Views
The Edit Views screen lets you create, modify and delete views. Views control how items are ordered and grouped together in List View. You can have several different views for a given list, or list type.
To Access the Edit Views Screen:
1) Tap the Views button in List View.
2) Tap Edit.
To Edit an existing View:
A) Tap the View
To Delete a View:
B) Tap the Delete Placard to the left of the item, then Delete.
To Add a New VIew
C) Tap on the "Tap To Add View" row.

To Access the Edit Views Screen:
1) Tap the Views button in List View.
2) Tap Edit.
To Edit an existing View:
A) Tap the View
To Delete a View:
B) Tap the Delete Placard to the left of the item, then Delete.
To Add a New VIew
C) Tap on the "Tap To Add View" row.

View Options Explained
Views consist of a Name, an Optional Grouping Hierarchy, an optional set of properties to sort items by, and optionally, an custom cell layout.
A) The Grouping Hierarchy will consolidate items with the same value for a property under a Group Header which lists the Value.
B) If multiple properties are grouped, the second group in the list isn't visible in the list until you Filter by a value in the first group.
C) Automatic Sorting lets you order items on the list within each group. If no group hierarchy is defined, the entire list is sorted. If no sorts are specified, then you can manually order items while in List View.
D) If you optionally enable and set a different Item Layout than the list's default (See Item Layout under List Options), then when the view is in use, Field positions an row colors will follow the custom layout.

A) The Grouping Hierarchy will consolidate items with the same value for a property under a Group Header which lists the Value.
B) If multiple properties are grouped, the second group in the list isn't visible in the list until you Filter by a value in the first group.
C) Automatic Sorting lets you order items on the list within each group. If no group hierarchy is defined, the entire list is sorted. If no sorts are specified, then you can manually order items while in List View.
D) If you optionally enable and set a different Item Layout than the list's default (See Item Layout under List Options), then when the view is in use, Field positions an row colors will follow the custom layout.

Sort and Group Options
A) When defining either a sort or a group, you must specify the list property to sort or group on.
B) When you add an Automatic Sort to a view, you can also specify the Sort Direction.
Groups are a bit more configurable and include options for:
C) Showing empty groups all the time, while editing or never.
D) Including items that don't have a value set when filtering on any group
These last two Group Options are explained in more detail the next two sections.

B) When you add an Automatic Sort to a view, you can also specify the Sort Direction.
Groups are a bit more configurable and include options for:
C) Showing empty groups all the time, while editing or never.
D) Including items that don't have a value set when filtering on any group
These last two Group Options are explained in more detail the next two sections.

Shows Empty Groups
The "Shows Empty Groups" (A) setting if the View shows the Group Header for all possible values even if there isn't a visible item for the Group Value on the list. (B)
This is useful While Editing because it lets you set list values on items such as Grocery Store by dragging items to different headers by the Move Handle (C).
Similarly while not in Edit mode, you can "Open a Group" (Such as a specific Store) and then add items to it regardless as to whether there was a visible item in the group already.
Note that for Grocery Sections, or fields that have may values, this setting is not recommended.

This is useful While Editing because it lets you set list values on items such as Grocery Store by dragging items to different headers by the Move Handle (C).
Similarly while not in Edit mode, you can "Open a Group" (Such as a specific Store) and then add items to it regardless as to whether there was a visible item in the group already.
Note that for Grocery Sections, or fields that have may values, this setting is not recommended.

Including Not Set Values when Filtering
When "Filtering Includes Not Set" (A) is enabled, tapping on a group header to filter the list (B) will include items that don't have a value set for the grouping property (C). This is useful for Grocery Lists when you don't care what particular store you plan to buy an item at. The item will still appear even when filtering by a specific Store value.


7. Miscellaneous
Restoring from an Email Backup
Forward the email with the .listbkup file to the device.
1) In the Mail app on the device, Press and HOLD on the .listbkup file in the email.
2) Tap "Open in Groceries"
3) You will be prompted to replace all data in the app with your backup.
Note that in backups sent from iPhone OS 3.1 and earlier, file attachments are not supported. Instead the backup is encoded in a link. Restoring from such a backup just involves clicking on the link in the Mail app on the device. These link can be truncated by Outlook and other mail programs if forwarded. Use the "Recoverable Backup" option (iPhone OS 3.1 Only) to ensure you can reconstruct the backup later. If you have problems with a backup, please contact support@ontomni.com

1) In the Mail app on the device, Press and HOLD on the .listbkup file in the email.
2) Tap "Open in Groceries"
3) You will be prompted to replace all data in the app with your backup.
Note that in backups sent from iPhone OS 3.1 and earlier, file attachments are not supported. Instead the backup is encoded in a link. Restoring from such a backup just involves clicking on the link in the Mail app on the device. These link can be truncated by Outlook and other mail programs if forwarded. Use the "Recoverable Backup" option (iPhone OS 3.1 Only) to ensure you can reconstruct the backup later. If you have problems with a backup, please contact support@ontomni.com

Restoring from a File Backup
First, get the file back onto the device from your computer:
1) Connect the device to your computer, Launch iTunes, click on the device in the left hand window
2) Click the "Apps" Tab in iTunes.
3) At the bottom of the window in the "File Sharing Section" click on "Groceries"
4) Click "Add..." and select the .listbkup file.
5) In Groceries, tap on the "i" button.
6) Tap on "Backup and Restore"
7) Click on the correct backup date at the bottom of the screen.
8) You will be prompted to replace all data in the app with your backup.

1) Connect the device to your computer, Launch iTunes, click on the device in the left hand window
2) Click the "Apps" Tab in iTunes.
3) At the bottom of the window in the "File Sharing Section" click on "Groceries"
4) Click "Add..." and select the .listbkup file.
5) In Groceries, tap on the "i" button.
6) Tap on "Backup and Restore"
7) Click on the correct backup date at the bottom of the screen.
8) You will be prompted to replace all data in the app with your backup.

Importing Items
Regular emails from Groceries and Listomni contain a link that let you import the items on another device which is running Groceries or Listomni. This is useful when splitting shopping lists up at the store.
1) In the Mail app on the device, tap the link in the email.
2) This will Launch Groceries and prompt you to import that items. Tap Import Items.
3) Select a list to import the item to.
Note you can also create a new list for the items by tapping the green plus button.

1) In the Mail app on the device, tap the link in the email.
2) This will Launch Groceries and prompt you to import that items. Tap Import Items.
3) Select a list to import the item to.
Note you can also create a new list for the items by tapping the green plus button.

Tips
1) When building a grocery List you can avoid typing items by instead Browsing the dictionary: (Blue Action Button->Browse Dictionary)
2) We do have a way (though admittedly clunky) to import items from your computer. (Search the help for "Entering Items on your computer" )
3) If you don't like the way a list is grouped, sorted, or which fields it displays in the list, change it! Purple Eye Button->Edit->Tap the view. (Search "Custom Views" in help)
4) To get back to the top of the list tap the iPhone Status Bar.
5) Hate the phone rotating the view while shopping? (Checkout the Settings screen to lock it.)

2) We do have a way (though admittedly clunky) to import items from your computer. (Search the help for "Entering Items on your computer" )
3) If you don't like the way a list is grouped, sorted, or which fields it displays in the list, change it! Purple Eye Button->Edit->Tap the view. (Search "Custom Views" in help)
4) To get back to the top of the list tap the iPhone Status Bar.
5) Hate the phone rotating the view while shopping? (Checkout the Settings screen to lock it.)

Gotchas
1) Renaming a section on the list, will not rename all occurrences of the section. Instead, tap the "i" button, tap on the Store Sections row, then rename the section there. This will update all items in the dictionary, and the list.


Frequent Crashes
If you experience frequent crashes, try rebooting the device. If that doesn't resolve the issue, please send us an email. We do reply!


Editing in List View
Depending on your settings, you can Edit item values that you can see in the list without having to leave the main list screen:
1) Tap Edit.
2) Tap the text on an item that you want to edit.
3) Set a new value.
See Edit Row Tap Behavior in Settings to enable this feature.

1) Tap Edit.
2) Tap the text on an item that you want to edit.
3) Set a new value.
See Edit Row Tap Behavior in Settings to enable this feature.

A. FAQ
Add and Remove Stores
To Add and Remove Grocery Stores from the Grocery List
1) Tap the "i" button to get to the Settings Screen.
2) Tap on "Stores"
A) Tap the Green plus button to add a store.
Or
B) Swipe an unwanted store and tap delete.

1) Tap the "i" button to get to the Settings Screen.
2) Tap on "Stores"
A) Tap the Green plus button to add a store.
Or
B) Swipe an unwanted store and tap delete.

Order My Store Sections
To Order Store Sections while viewing the grocery list by Section:
1) Tap Edit
2) Tap the Move Button on the right side of any group header.
C) Drag the Sections to the order you want using the move handle on the right hand side of the item.

1) Tap Edit
2) Tap the Move Button on the right side of any group header.
C) Drag the Sections to the order you want using the move handle on the right hand side of the item.

Setting the Store
You can set the store for a grocery item while viewing the Grocery List several ways:
Set the store on the item while editing or adding (Purple)
1) Tap the Item
2) Tap Store
3) Pick a value.
By Dragging items to the store. (Blue)
1) Tap the Purple Eye Button.
2) Tap "Group By Store, then Section"
3) Tap Edit.
4) Use the handle on the right of the item to drag it to the correct store.
Or via Edit Multiple Items... (Red)
1) Tap Edit
2) Select items to set the store for by tapping on the red circle to their left.
3) Tap the Green Multi Edit Button.
4) Set the Store
5) Set a Value
6) Tap Apply.
Note that to have an item show up when filtering by any store, leave the store blank.

Set the store on the item while editing or adding (Purple)
1) Tap the Item
2) Tap Store
3) Pick a value.
By Dragging items to the store. (Blue)
1) Tap the Purple Eye Button.
2) Tap "Group By Store, then Section"
3) Tap Edit.
4) Use the handle on the right of the item to drag it to the correct store.
Or via Edit Multiple Items... (Red)
1) Tap Edit
2) Select items to set the store for by tapping on the red circle to their left.
3) Tap the Green Multi Edit Button.
4) Set the Store
5) Set a Value
6) Tap Apply.
Note that to have an item show up when filtering by any store, leave the store blank.

Entering Items by Computer
You can enter items on your computer and mail them to your device. This is useful when importing large lists from other programs.
For more information visit our website:
www.ontomni.com->Support->Listomni->"Want to Enter List Items on Your Computer?"
http://www.ontomni.com/listomniBetaGenerator.htm

For more information visit our website:
www.ontomni.com->Support->Listomni->"Want to Enter List Items on Your Computer?"
http://www.ontomni.com/listomniBetaGenerator.htm

Splashscreen
Many people have contacted us asking to disable the splash screen when the app first opens.
Currently there isn't a way to disable the splash screen, mainly because of the way that third part apps are launched by the iPhone OS:
There is about a second or two of application launch time which is all Apple overhead. This is hidden in the built in applications such as Notepad, Mail and Safari, because Apple actually shows you a splash screen which was a screen shot from the application the last time it was closed. (Try clicking around in notes or mail immediately after launching and you'll notice it doesn't respond for 1-2 seconds.)
Apple doesn't currently enable this trick for 3rd party applications. We can only have a static image which is displayed during this time (The splashscreen) (It's either that or a black screen during this time) We will be looking to change this and appropriate Apple's little trick as soon as they open it up, as we agree that there is value of being able to see what's on the list right away even before you can interact with it.

Currently there isn't a way to disable the splash screen, mainly because of the way that third part apps are launched by the iPhone OS:
There is about a second or two of application launch time which is all Apple overhead. This is hidden in the built in applications such as Notepad, Mail and Safari, because Apple actually shows you a splash screen which was a screen shot from the application the last time it was closed. (Try clicking around in notes or mail immediately after launching and you'll notice it doesn't respond for 1-2 seconds.)
Apple doesn't currently enable this trick for 3rd party applications. We can only have a static image which is displayed during this time (The splashscreen) (It's either that or a black screen during this time) We will be looking to change this and appropriate Apple's little trick as soon as they open it up, as we agree that there is value of being able to see what's on the list right away even before you can interact with it.

Second Group Not Visible!
The Group By Store then Section view is only showing Stores not Sections!
This is actually by design. Only one grouping is visible at a time. You need to filter on a specific group in order to see the second level of grouping
1) Tap a Group Header to Filter on that Group an see the items in that group grouped by the second Level in the Grouping hierarchy:
2) Tap the back button to remove the filter.

This is actually by design. Only one grouping is visible at a time. You need to filter on a specific group in order to see the second level of grouping
1) Tap a Group Header to Filter on that Group an see the items in that group grouped by the second Level in the Grouping hierarchy:
2) Tap the back button to remove the filter.
