Products & Orders
Manage your product catalog, inventory, variants, and order lifecycle.
Products
Adding a Product
- In the left sidebar, click Products
- Click the Add Product button in the top-right corner
- Fill in the product form (details below)
- Set the status to Active when you're ready for customers to see it
- Click Save in the top-right corner
Product Fields
| Field | Required | Description |
|---|---|---|
| Title | Yes | Your product name — the AI uses this to match customer queries |
| Description | No | Detailed product description — the AI uses this to explain products to customers |
| Status | Yes | Draft (hidden), Active (visible), or Archived (removed from catalog) |
| Category | No | Select a category to organize products on your storefront |
| Images | No | Upload product photos by dragging into the image area, or click Generate with AI to create images (see AI Image Generation) |
| Tags | Auto | Automatically generated for search, but you can add custom tags too |
| Search Terms | No | Alternate names or synonyms customers might use. For example, if you sell "bitter leaf," you might add "onugbu" as a search term so Nigerian customers can find it |
Variants
If your product comes in different sizes, colors, or options, toggle Has Variants in the product form.
Setting up options:
- Click Add Option — you can add up to 3 option types
- Choose a preset option type (Color, Size, Material, Style) or type a custom name
- Add values for each option (e.g., for Size: Small, Medium, Large)
- Use the quick-add presets to quickly add common values (like standard clothing sizes)
- Click Generate Variants to automatically create all possible combinations
Each variant has its own fields:
| Field | Description |
|---|---|
| SKU | Auto-generated if you leave it blank, or enter your own |
| Price | The selling price for this variant |
| Compare at Price | The original price (shown crossed out to indicate a discount) |
| Cost Price | Your cost — used for profit calculations (not shown to customers) |
| Stock Quantity | How many units you have |
| Low Stock Alert | PalySales notifies you when stock drops below this number |
| Track Inventory | Toggle on to automatically decrease stock when orders are placed |
| Barcode | Optional barcode or UPC |
| Variant Image | Upload a specific image for this variant (e.g., a photo of the red version) |
Semantic Search
When you save a product, PalySales automatically creates a vector embedding from the title + description + search terms. This powers natural language search:
- Customers can ask "something warm for winter" and find jackets
- Customers can ask "do you have anything blue?" and find all blue products
- The AI searches by meaning, not just exact word matches
Products with a similarity score above 0.35 are returned. If semantic search doesn't find anything, PalySales falls back to tag search, then fuzzy text search.
Categories
Organize products into categories:
- In the left sidebar, click Products
- Click the Categories tab (or go to Settings → Categories)
- Create categories with a name, optional image, and optional parent category (for hierarchical organization)
Each category can have search terms to help the AI find the right category when customers ask about a type of product.
Orders
Order Lifecycle
Orders flow through these statuses:
| Status | Color | What It Means |
|---|---|---|
| Pending | Amber | Order created, waiting for payment or confirmation |
| Confirmed | Blue | Payment received, order is accepted |
| Processing | Blue | You're preparing the order |
| Shipped | Purple | Order is on its way (tracking number added) |
| Delivered | Green | Customer received the order |
| Cancelled | Red | Order was cancelled |
| Refunded | — | Payment was refunded |
Automatic confirmation: When a payment status changes to Paid and the order is in Pending status, it automatically moves to Confirmed.
How Orders Are Created
Orders come from three sources:
| Source | How It Happens |
|---|---|
| AI Conversation | A customer tells the AI "I want 2 red t-shirts in size L" — the AI creates the order, validates stock, and generates a payment link |
| Storefront | A customer adds items to cart on your online store and completes checkout |
| Manual | You create an order in the dashboard (click Orders in the left sidebar → Create Order) |
Managing Orders
- In the left sidebar, click Orders
- You'll see a table (on desktop) or cards (on mobile) showing all orders
- Use the filter tabs at the top: All, Pending, Abandoned, Confirmed, Processing, Shipped, Delivered, Cancelled
- Click an order to view details
- Use the quick action buttons to change status
Updating Order Status
To update an order's status:
- Open the order detail page
- Click the status update button (or select from the dropdown)
- Optionally add a tracking number (for shipped orders)
- Choose whether to send a notification to the customer
Notifications: By default, status changes send a WhatsApp message to the customer. You can disable this per status update.
| Status Change | Customer Gets |
|---|---|
| Confirmed | "Your order has been confirmed!" |
| Processing | "Your order is being prepared" |
| Shipped | "Your order has been shipped" + tracking number (if provided) |
| Delivered | "Your order has been delivered" |
| Cancelled | "Your order has been cancelled" |
Abandoned Order Recovery
If a customer started checkout but didn't complete payment, the order shows as Abandoned. You can:
- Filter orders by Abandoned using the tab at the top
- Click the order to open it
- Click Send Recovery Link to send the customer a reminder with a link to complete their purchase
Delivery Types
| Type | Description |
|---|---|
| Pickup | Customer picks up at your location |
| Delivery | Local delivery within your configured delivery zones |
| Shipping | Shipped via carrier with tracking number |
Configure delivery zones in Settings → Storefront → Checkout & Payments. Each zone has a name, fee, minimum order amount, and estimated delivery time.
Payment Methods
Available payment methods depend on your region:
| Region | Provider | Methods |
|---|---|---|
| Global (USD) | Stripe | Credit cards, debit cards |
| Nigeria (NGN) | Paystack | Cards, bank transfer, USSD |
| Nigeria (NGN) | Flutterwave | Cards, bank transfer |
Additionally, your storefront supports:
- Interac e-Transfer — for Canadian customers (manual confirmation)
- Pay on Delivery / Cash on Delivery — toggle in storefront settings
- WhatsApp Order — cart sent to WhatsApp for AI-assisted checkout
Configure accepted methods in Settings → Storefront → Checkout & Payments.