Item Management

The Item Management page is available at:

https://app.pixaro.ai/items

Feature Overview

Item Management is used by store owners, managers, and store team members to manage the store catalog used for ordering and menu publishing.

From this page, store teams can search items, filter the catalog, add new items, update existing items, upload items in bulk, and review menu ingestion audit logs.

The catalog is store-specific. If the active store is changed from the top toolbar, Item Management shows items for the newly selected store.

Access and Navigation

Navigation path: Order Management > Item Management

Required permissions: Item Management access. Depending on the account setup, this may be granted through ItemTabView or ItemAll.

Item List

The Item Management page shows catalog items in a paginated grid.

At the top of the page, store team members can see:

• The page title, Item Management.
• A short description: search, filter, add, and bulk import store catalog items.
• The current number of matching records.

Search

Use the search field to search by item name or UPC.

Search updates automatically shortly after typing and returns the list to the first page.

Filters

Click Search Filter to open the advanced filter dialog.

Available filters include:

Filter	Meaning
Category	Filters items by category or store department.
UPC	Searches for a specific UPC.
Size	Filters by item size.
Min Price / Max Price	Filters store items by price range. This is hidden for the master catalog.
Item Status	Filters Active or Inactive items.
Verification	Filters Verified or Pending items.
Channel Publishing	Filters items by Uber Eats or Grubhub publish status.
Product Flags	Filters Alcohol, Tobacco, Hemp, or THC items.

Use Apply to apply filters.

Use Clear to reset filters.

Selected filters appear as chips above the grid.

Item Grid Columns

The item grid displays these columns:

Column	Meaning
Image	Product image for the item.
Name	Item name.
Category	Item category or store department.
Size	Item size. Shows N/A when size is not available.
Price	Store item price. This column is hidden for the master catalog.
UPC	Item UPC.
Verified	Shows whether the store item is verified or pending. This column is hidden for the master catalog.
Channels	Shows publish status for supported channels, currently Uber Eats and Grubhub. This column is hidden for the master catalog.
Active	Shows whether the item is active or inactive.
Action	Pencil icon used to edit the item.

Click an item row or the pencil icon to open the item edit page.

Channel Publishing Status

The Channels column shows publishing status for supported ordering channels.

Current visible channels:

• Uber Eats
• Grubhub

Each channel icon can show:

Status	Meaning
Published	The item is published for that channel.
Not published	The item is not currently published for that channel.
Unchecked	Pixaro has not confirmed publish status for that channel.

Adding an Item

Click Add to create a new item.

The add page is available at:

/items/add

Fields include:

Field	Meaning
Image	Product image.
UPC	Item UPC. UPC must contain digits only and must be 14 digits or fewer.
Name	Item name.
Category	Item category or store department.
Size	Item size.
Price	Store item price. Required for regular store items.
Product Flags	Alcohol, Tobacco, Hemp, and THC flags. These are editable only in the master catalog.
Active	Controls whether the item is active or inactive.

To add an item:

1. Click Add.
2. Upload an item image.
3. Enter the UPC.
4. Enter or review the item name.
5. Select a category or department.
6. Enter size and price where applicable.
7. Set the item as Active or Inactive.
8. Click Save.

When a UPC matches existing master item data, Pixaro may auto-fill item details such as name, size, category, and image.

After a single item is added, the saved item appears in Pixaro, but the change is not immediately reflected in connected ordering channels. Channel updates can take up to 4 hours to appear in the respective channels.

Editing an Item

To edit an item:

1. Open Order Management > Item Management.
2. Search or filter to find the item.
3. Click the item row or pencil icon.
4. Update the required fields.
5. Click Update.

On the edit page, UPC is read-only. To change a UPC, create a new item with the correct UPC.

After a single item is edited, the saved changes appear in Pixaro, but connected ordering channels may not show the update immediately. Allow up to 4 hours for the change to reflect in each channel.

Channel Update Timing

Single-item add and edit changes are saved in Pixaro first. Connected channels such as Uber Eats and Grubhub may take up to 4 hours to show the latest item name, price, image, availability, or other item details.

During this time:

• The item can already be visible with the updated details inside Pixaro.
• Channel icons may still show the previous publish state until channel verification refreshes.
• Store teams should wait for the channel update window before treating the change as failed.
• Use Audit Log when a menu ingestion or publishing job fails, returns an error, or does not complete after the expected update window.

Active and Inactive Items

Use the Active switch on the add/edit page to control item availability.

• Active: Item is available for store catalog workflows.
• Inactive: Item remains in the catalog but should not be treated as active.

Bulk Upload

Click Bulk Upload to import multiple items at once.

Supported file formats:

• .csv
• .json

After selecting a valid file, Pixaro displays a preview dialog. Click Upload to submit the import or Close to cancel.

CSV Structure

For regular store items, the CSV must contain exactly these columns:

Column	Required	Notes
Name	No	Item name.
Category	No	Store department/category name.
UPC	Yes	Digits only, 14 digits or fewer, greater than 0.
Price	Yes	Must be a valid number.
Size	No	Item size.

For master catalog items, the CSV must contain exactly these columns:

Column	Required	Notes
Name	Yes	Item name.
Category	Yes	Master category name.
UPC	Yes	Digits only, 14 digits or fewer, greater than 0.
Size	No	Item size.
IsAlcohol	No	true, false, or blank.
IsTobacco	No	true, false, or blank.
IsHemp	No	true, false, or blank.
IsThc	No	true, false, or blank.

CSV uploads fail if required columns are missing or unsupported columns are included.

JSON Structure

For regular store item JSON uploads, each item must include:

• upc
• price

For master catalog JSON uploads, each item must include:

• name
• category
• upc

Optional JSON fields may include:

• size
• isAlcohol
• isTobacco
• isHemp
• isThc

The JSON file must contain an array of item objects.

Bulk Upload Validations

Pixaro validates the file before upload.

Common validation rules:

• File must be CSV or JSON.
• CSV headers must match the expected structure.
• JSON must be an array.
• Required fields must not be blank.
• UPC must contain only digits.
• UPC must be 14 digits or fewer.
• UPC must be greater than 0.
• Price must be a valid number.
• Empty rows are skipped.
• If any row has an error, the file is stopped and must be corrected before upload.

Common errors include:

Error	Resolution
Unsupported file type	Upload a .csv or .json file.
Invalid CSV headers	Use the exact column names required for the store type.
Missing required fields	Fill in the required values for the reported row.
Invalid UPC	Use numeric UPC values only, 14 digits or fewer.
Invalid Price	Use a valid numeric price.
Uploaded file does not contain any item rows	Confirm the file has item rows below the headers.
UberEats store deactivated	Activate the Uber Eats store before updating Uber Eats menu items.

Menu Audit Log

Click Audit Log to view menu ingestion activity for the selected store.

The Menu Audit Log helps store owners, managers, and support teams review menu updates sent to ordering channels.

Available audit filters:

Filter	Options
Date Range	Today, Yesterday, Last 7 Days, Last 30 Days, Custom Date
Channel	All Channels, Uber Eats, Grubhub
Status	All Statuses, Success, Failed

Audit results show:

• Channel
• Who requested the update
• Date and time
• Status
• HTTP response status
• Item count
• Skipped item count

Open an audit row to view details such as source, duration, item counts, failure reason, and response payload.

Troubleshooting

Issue	What to Check
No items are shown	Confirm the selected store, clear filters, and check Item Management permission.
Item cannot be saved	Confirm required fields are complete and the UPC is valid.
Price error appears	For regular store items, enter a price of at least 1 on the add/edit form.
Image upload error appears	Upload a valid item image.
UPC cannot be edited	UPC is read-only when editing an existing item. Create a new item if the UPC is incorrect.
Bulk upload fails	Review the error message, fix the reported row or header issue, and upload again.
Item change is not visible in a channel yet	Single-item add/edit changes can take up to 4 hours to reflect in connected channels.
Item is not published to a channel	Check the channel icon status and review the Menu Audit Log after the expected update window.
Uber Eats update fails	Confirm the Uber Eats store is active before updating menu items.

Best Practices

• Confirm the selected store before adding or editing items.
• Search by UPC when matching a specific product.
• Keep item images, names, sizes, and prices accurate before publishing to ordering channels.
• Use Inactive instead of deleting unavailable items when the item may return later.
• Review the Menu Audit Log after bulk uploads or channel publishing issues.
• Validate CSV files before upload, especially UPC and price columns.