Products Overview
Manage your product catalog so AI agents can search, recommend, and showcase products to customers during conversations.
Path: Products
The Products section has its own sub-navigation: My Products (the catalog) and Sources (Shopify and Zid integrations).
Products Grid
The Products page displays all your products in a searchable, sortable grid.
Grid Columns
| Column | Description |
|---|---|
| Checkbox | Select products for bulk actions |
| Image | Product thumbnail (first image) |
| Product Name | Name in both English and Arabic |
| Category | The product's category |
| Status | Active or Inactive |
| Source | Manual, Shopify, or Zid |
| Price | Product price |
| Stock | Available stock |
| Variants | Number of variants |
| Tags | Product tags |
| Actions | View, Edit (manual only), Delete |
Searching Products
Use the search bar to find products by:
- Product name (English or Arabic)
- Description keywords
Filtering Products
Filter your product list to find specific items quickly.
Available Filters
| Filter | Description |
|---|---|
| Source | Filter by Manual, Shopify, or Zid |
| Status | Filter by Active or Inactive products |
Using Filters
- Click the filter icon next to the search bar
- Select your filter criteria
- The grid updates automatically
- Click Clear Filters to reset
Adding Products Manually
Create products directly in Orki without connecting an e-commerce platform.
Creating a New Product
- Click the "Add Product" button
- Fill in the product details (see table below)
- Add product images
- Click "Save"
Product Fields
| Field | Description | Required |
|---|---|---|
| Name (English/Arabic) | Product name | Required in the active UI language; the other language is optional |
| Description (English/Arabic) | Product details | Required in the active UI language; the other language is optional |
| Price | Product price | Yes |
| Category | Product category | Yes |
| Supplier | Product supplier | Yes |
| Tags | Product tags | At least one required |
| Status | Active or Inactive | Yes |
| Images | Product photos (multiple allowed) | Recommended |
Filling in both English and Arabic names and descriptions ensures your AI agent can assist customers in either language.
Variants and Options
Define options (e.g., Size, Color) and their values — Orki generates the variants from the combinations. Each variant has its own price, stock, and URL.
Related Products
Link up to 5 related products the AI can suggest alongside this one.
Product Images
- Upload multiple images per product
- First image becomes the thumbnail
- Drag to reorder images
- Supported formats: JPG, PNG, WebP
- Recommended minimum size: 800x800 pixels
Product Status
Control whether products appear in AI searches and recommendations.
| Status | Description |
|---|---|
| Active | Product is available for AI to search and recommend |
| Inactive | Product is hidden from AI searches (useful for out-of-stock or discontinued items) |
Changing Status
Single Product:
- Find the product in the grid
- Click the status toggle to switch between Active/Inactive
Multiple Products:
- Select products using checkboxes
- Use bulk actions (see below)
Bulk Actions
Perform actions on multiple products at once.
Available Bulk Actions
| Action | Description |
|---|---|
| Activate | Set selected products to Active status |
| Deactivate | Set selected products to Inactive status |
| Delete | Remove selected manual products |
Using Bulk Actions
- Select products using the checkboxes in the grid
- Click the "Bulk Actions" dropdown
- Choose the desired action
- Confirm when prompted
You can only delete manual products. Products synced from Shopify or Zid must be deleted from their source platform.
Product Details Page
Click on any product to view its full details.
Information Displayed
- All product images (full gallery)
- Name in English and Arabic
- Description in English and Arabic
- Price, stock, and variants
- Category, supplier, and tags
- Status (Active/Inactive)
- Source (Manual, Shopify, or Zid)
- Last synced date (for integration products)
Editing Products
Manual Products: Click "Edit" to modify any field.
Integration Products (Shopify/Zid): Products synced from integrations are read-only in Orki. To update them, make changes in the source platform and they will sync automatically.
Photo Search
Photo Search allows customers to find products by sending an image.
How It Works
- Customer sends a photo in chat (e.g., a screenshot from social media)
- AI analyzes the image using visual recognition
- AI searches your product catalog for similar items
- Matching products are presented to the customer
Example Conversation
Customer: [Sends photo of a red handbag]
AI: "I found some similar bags in our collection! Here are the closest matches:" [Shows product carousel with matching items]
Requirements
- Photo Search is automatically enabled when you have products
- Works best with clear, well-lit product photos in your catalog
- Supports common image formats (JPG, PNG, WebP)
Upload multiple angles of each product to improve Photo Search accuracy.
How Products Work with AI
Your product catalog integrates with AI agents to provide shopping assistance.
Product Search Tool
AI agents can search your catalog based on customer requests:
- By name or keywords
- By price range
- By category or type
- By visual similarity (Photo Search)
Product Recommendations
During conversations, AI can:
- Suggest relevant products based on customer needs
- Compare products and explain differences
- Provide pricing and availability information
- Send product carousels on WhatsApp
Product Carousels
On WhatsApp, AI can send interactive product cards:
- Product image
- Name and price
- "View" button for details
- Customers can swipe through multiple products
Example Interaction
Customer: "I'm looking for a gift under $50"
AI: "I'd be happy to help! What type of gift are you looking for? We have jewelry, accessories, and home décor in that price range."
Customer: "Something for my mom, she likes jewelry"
AI: "Here are our most popular jewelry items under $50:" [Sends carousel with necklaces, bracelets, and earrings]
Product Sources
Products can come from three sources:
| Source | Description |
|---|---|
| Manual | Products created directly in Orki |
| Shopify | Products synced from your Shopify store |
| Zid | Products synced from your Zid store |
You can use multiple sources simultaneously. Products from all sources appear in the same grid and are searchable by AI.
Next Steps
- Connect Shopify — Sync products from your Shopify store
- Connect Zid — Sync products from your Zid store
- AI Agents — Configure how agents use products