Documentation

Commerce

Catalog and products

Add products or restaurant dishes, import them from files, publish a shareable public catalog, and control what the AI can quote to customers.

Last updated: 2026-09-29

Your catalog is the list of things you sell: products for a store, dishes for a restaurant. It is the source of truth the AI reads when a customer asks "do you have it?" or "how much?". This page shows how to build it, import it in bulk, publish a public link, and keep it accurate.

Which screen you get depends on your Environment (Settings, then Environment):

EnvironmentCatalog screenWhere to find it
Store (standard)ProductsAutomation, then Catalog & AI, then Products
Store (consultation)Products, with consultation fieldsSame place
RestaurantRestaurant menuAutomation, then Catalog & AI, then Restaurant menu
General business or AppointmentsNo catalog screenUse the knowledge base for services and prices

How the AI uses your catalog#

When a customer asks about an item, the AI searches your products or menu, then reloads the exact record before it states a price or availability. In practice:

  • It quotes the stored name, price and currency, and gives the stored product link when there is one.
  • Items priced Quote required or Display label are never presented as an exact price.
  • It matches by name, Arabic and English names, and aliases. If nothing matches exactly, it may offer a few close candidates and ask the customer which one they mean. It never treats a close candidate as confirmed.
  • Search results are limited (the first 1,000 products or active dishes), so an empty result is not treated as proof that an item does not exist.
  • A workspace with no catalog (General business, Appointments) cannot quote products. It can only answer from the knowledge base and hand off to your team.

If the drafted reply contains a price or name the tools did not return, a second check rejects it and the customer gets a hedged answer instead. If that happens repeatedly the conversation is handed to your team. See Improving answer quality.

Add products (store)#

  1. Open Products.
  2. Select Add Product.
  3. Fill in the fields, then select Save Product.
FieldWhat it does
Product NameThe main identity. Duplicate names are refused.
Arabic name, English nameOptional. Used for matching and for replies in the customer's language.
Alternative or street namesAliases such as the name customers actually type. Separate with | or a new line.
Product linkShared with customers when they ask for it. Sela does not open or fetch it.
CategoryGroups items in the list and in the public catalog.
PricingFixed price, Starting at, Display label, or Quote required.
Price amount and CurrencyRequired for fixed and starting prices. Currency is IQD or USD. Sela never converts currencies.
DescriptionShown to the AI as evidence about the product.
Product imageUsed in the public catalog and for matching photos customers send.
Availability (In stock)Out-of-stock items stay visible but are reported as sold out.

Consultation stores also see fields such as Custom-made, Lead time (days), Installments, Required measurements, Recommendation notes, Visual description and Style tags. They help the AI recommend options and route custom cases to your team.

Use Alternative or street names generously. Arabic spelling variants are normalized for search, but only a saved alias can bridge a nickname such as a brand slang term.

Import products in bulk (store)#

Imports need the AI Assist add-on with credits, because the AI reads and structures the file. An import never publishes anything by itself: it produces drafts that you review first. See Plans and billing for plans and credits.

SourceButtonLimits and notes
CSV, Excel (.xlsx)Import catalog5 MB, 500 rows, 64 columns. A bad row rejects the file and names the row number.
TXTImport catalogUp to 40,000 characters and 20 drafts. Uses AI extraction. Use CSV or Excel for a complete table.
PDFImport catalog25 MB. The PDF is also indexed into the knowledge base.
Photo of one productImport from imageOne image, produces one draft.
Instagram postsImport from InstagramNeeds Instagram connected. Pick image or carousel posts to turn into drafts.

CSV and Excel format#

In the Import catalog dialog, select Download CSV template. The columns are:

text
name,nameAr,nameEn,aliases,description,pricingMode,priceAmount,priceCurrency,priceLabel,inStock,category,productUrl,imageUrl
  • Only name is required.
  • pricingMode is fixed, starting_at, quote_required or label_only. Fixed and starting prices need a positive amount and an explicit IQD or USD. A missing price becomes Quote required.
  • inStock accepts true/false, 1/0, yes/no, available/unavailable, or Arabic equivalents. If you omit it, the draft is marked unavailable with a warning.
  • Friendly English and Arabic headers such as product name or اسم المنتج are accepted.
  • For Excel, use a worksheet named Products, or a workbook with exactly one visible sheet. Formulas are rejected.
  • Arabic digits and properly grouped thousands work. Ambiguous comma decimals fail with a row error.

Review and publish the drafts#

  1. After the upload, the review cards show names, aliases, price, stock, warnings and the source evidence.
  2. Edit anything uncertain (Save draft) or reject drafts you do not want.
  3. Select drafts and choose Publish selected. Up to 500 drafts publish at once.

Published products are available to the AI immediately. Publishing a draft whose name already exists fails, and imports never overwrite existing products.

Re-uploading identical file contents reuses the earlier import. After a failed import you can upload again to start a new attempt.

Learn tone from Instagram#

Learn tone analyses your Instagram captions and messages and proposes a tone. It appears as Pending tone review with Apply tone and Reject. Nothing changes until you apply it.

Restaurant menu#

Open Restaurant menu (Restaurant environment only). The page is described as the authoritative dishes, prices and availability used by your team and AI. It has tabs for Dishes, Import, and History.

  • Categories: select Manage categories to add, restore or archive.
  • New dish: names and descriptions in English and Arabic, ingredients, tags, a Price and Currency, or Price label when not numeric (for example Market price). Add Variants for sizes. Dish images are JPEG, PNG or WebP up to 8 MB.
  • Status: Available, Sold out, Hidden, Archived. Only Available and Sold out dishes are orderable and visible in the public catalog. A sold-out dish can be identified but not ordered.
  • Menu readiness shows whether the menu is ready to use.
  • History and Rollback restore the previous menu. Undo reverses a single edit while it is still safe.

Name and description edits are re-indexed for search. Price and availability changes apply immediately.

Import a menu from Markdown#

  1. On the Import tab, open Import menu Markdown and paste the menu (up to 2 MB and 2,000 dishes).
  2. Select Preview & reconcile to compare current and incoming values. Optionally tick Archive existing dishes not present in this file.
  3. Select Apply & publish.

The importer reads categories, dishes and variants. If the Markdown includes a seven-day hours table, hours update only when all seven days are understood; otherwise you will see a warning and hours stay as they were. Working hours are managed in Environment.

There is no direct import from a photographed or PDF menu for restaurants. Retype or convert it to Markdown first.

Import dish images from MenuPlus#

Paste a MenuPlus menu URL under Import dish images from MenuPlus and select Preview images. Only images are reconciled. Names, prices, categories, variants and availability are never changed. Existing images are kept unless you tick Replace existing images only for rows manually selected. Failed rows can be retried with Retry failed.

Public catalog page#

Restaurants and standard stores (not consultation stores) can publish a visual catalog with one shareable link. The Public catalog panel sits at the top of Products or Restaurant menu.

  1. Fill in English catalog title and Arabic catalog title (up to 100 characters each).
  2. Choose an Accent color (six-digit hex) and optionally upload a Logo.
  3. Select Save settings. Branding must be saved before the first publish.
  4. Select Preview to check the result, then Publish.
  5. Use Copy link or Download QR to share it.

Customers see your items grouped by category, with search, English and Arabic switching, prices and a sold-out marker. The page does not take orders. Customers keep chatting with your AI to order.

After the first publish, changes to items, categories, prices, availability and branding sync to the public page automatically. If a sync fails, the last good version stays public, the panel shows the error, and Retry sync appears. Unpublish removes the page.

When a catalog is published, the AI uses its link for requests like "send me the menu". Before the first publish or after unpublishing, restaurants fall back to the menu link saved on the restaurant profile. Embedding the catalog on your own site is covered in Forms and catalog embeds.

Keep the catalog accurate#

  • Update price and availability in the catalog, never in knowledge-base text or persona instructions.
  • Mark items Sold out or out of stock instead of deleting them, so history stays intact.
  • Add aliases for names customers type in Iraqi Arabic, English or transliteration.
  • Test after big changes: ask the AI for an item's price and availability in the widget or a test number.

Troubleshooting#

SymptomLikely cause and fix
The AI says it cannot find an item that existsAdd an alias or Arabic and English names. Check the item is available (not Hidden or Archived).
No catalog screen in the navigationYour Environment is General business or Appointments. Change it in Environment.
Import buttons are missing or refuseYou need the AI Assist add-on with credits and a Store environment.
"Catalog exceeds the 1,000-product import limit"Remove products or split the catalog.
An import row is rejectedFix the row number shown in the message and upload again.
Public catalog panel is missingConsultation stores and other environments are not eligible.
AI quotes "price varies"The item is Quote required or Display label. Set a fixed price if it should be quoted.
Wrong currency shownCurrency is stored per item. Edit the item. Sela does not convert.

Next: Orders and payment links explains how a catalog item becomes an order.

Catalog and products | Sela docs | Sela