Seller User Manual

Two role cards are shown — Buyer and Seller. Click the Seller card (it highlights with an orange border) then click Continue.

This step is shown to sellers only. Choose between:

• Individual — A sole trader or personal business.
• Company — A registered business or organisation.

Select the option that matches your situation and click Continue.

Fill in your personal account details:

• Full Name — Your name as the account holder.
• Email — Used to log in and receive notifications. Optional if you use a phone number.
• Phone Number — Your Kenyan mobile number (e.g. 07XXXXXXXX). Optional if you use email.
• Password — Minimum 6 characters.
• Confirm Password — Must match the password above.

Alternatively click Continue with Google to sign up instantly using your Google account. Then click Create account.

If you haven't created a business yet, you'll see a prompt to get started. Click Create Business to open the two-step setup wizard.

Step 1 — Basic Info:

• Business Name (required) — The name that appears publicly on the marketplace.
• Description — A short paragraph describing what your business offers. Be specific — this text appears on your public profile.
• Category (required) — The primary category that best describes your business (e.g. Restaurants & Food, Retail, Services).
• Subcategory — A more specific classification within your category. Appears when subcategories are available for the selected category.

Step 2 — Location:

• Country — Select from the dropdown.
• County — Select your county. If your county isn't listed, choose Enter manually and type it — the system will attempt to verify the location via geocoding.
• Locality — Your specific area or neighbourhood within the county. Same manual-entry option applies.

Click Create Business on Step 2 to save. Once created, your business is submitted for review before going live on the marketplace.

Once your business exists, the My Business page shows your profile card alongside info cards for status, creation date, and location. Click Edit on the profile card to update your name, description, category, subcategory, or location. Changes save immediately.

Additional editable sections below the profile card include:

• Contact details — Phone, email, and social media links (Facebook, Instagram, X, WhatsApp, website).
• Business Hours — Click Business Hours to set your opening and closing times for each day of the week.
• Tags & Brands — Associate relevant tags and brands with your business to improve discoverability.

Your profile card has two image upload zones — the logo (circular) and the cover image (wide banner). Click the camera icon on either to upload:

• Logo — Recommended 400 × 400 px, square. PNG with transparent background works best.
• Cover image — Recommended 1280 × 480 px, landscape. Appears as a banner across the top of your public business page.

Drag and drop or click to browse your files. The image uploads and saves automatically.

Click Boost Business on your profile to purchase a paid promotion that increases the visibility of your business listing across the marketplace. Select a boost package, duration, and complete payment. Active boosts appear under My Promotions in the sidebar.

Click + New Catalogue, enter a name, select the type, and save. Your new catalogue appears in the list as a draft. Click into it to add products — search your existing product catalogue and click Add on any product to include it. Products can belong to multiple catalogues.

Click Publish to make the catalogue visible to buyers on your business profile. Click Unpublish to hide it without deleting it.

Click + Add Branch. The create form has the following fields:

• Branch name (required) — The public name of this location.
• Description — Optional short description of the branch.
• Country (required) — Select from the dropdown.
• Override category — Check this if this branch operates in a different category from your main business.

Click Create branch to save. The new branch appears as a card in your branches list. Click any branch card to open its management view, which has tabs for:

• Business Profile — Branch name, location, contact details, and assigned managers.
• Notices — Announcements for this branch's customers.
• Products — Products specific to this branch.
• Banners — Promotional banners linked to this branch.
• Chats — Customer messages directed at this branch.

Click the Assign Managers button on a branch card to grant another user access to manage that branch. Managers can update branch details, handle orders, and respond to chats — without having access to your main seller account.

Click + Add Notice. The form has two steps:

1. Details — Enter a Title (required), Description (optional), Start Date (required, defaults to today), and End Date (required). Click Continue.
2. Media — Upload one or more images to accompany your notice. Images appear alongside the notice text on your business profile. This step is optional — click Skip or Done when finished.

A new notice is saved as Draft. Click Send (the paper-plane icon) in the actions menu to submit it for review. Once approved it becomes Published.

Each notice moves through the following states:

Click + Add Product to open the five-step product form.

Step 1 — Basics:

• Product Name (required) — The full name as buyers will see it.
• Description — Detailed product information: materials, dimensions, features, care instructions.
• Category — Pre-filled from your business category, read-only.
• Subcategory — Optional. Filtered to your business category.
• SKU — Auto-generated. Shown read-only for your reference.

Step 2 — Pricing:

• Price (required) — Retail price in KES.
• Currency (required) — Defaults to KES.
• Add tax at checkout — Check this box to apply VAT or tax to this product at checkout.

Step 3 — Inventory:

• Track stock — Enable to automatically mark the product out of stock when quantity reaches zero.
• Allow backorders — Let buyers purchase even when stock is depleted. Only available when Track stock is on.

Step 4 — Media:

• Main image — The primary thumbnail shown across the marketplace. Recommended: 4:3 ratio, minimum 1200 × 900 px, max 5 MB, JPG / PNG / WebP. Drag and drop or click to browse.
• Gallery — Additional product photos (up to 8 total including the main image). Same format requirements.

Step 5 — Review: A summary of everything you've entered. Check for mistakes then click Save Product to publish, or go back to any step to edit.

If your product comes in multiple options — size, colour, material — add variants so buyers can choose before adding to cart. Open any product and click the Variants button in the page header to open the variants list. Click + Add variant to launch the three-step variant wizard.

Step 1 — Attributes:

• SKU — Auto-generated from the product name and the attributes you set. Updates as you fill in the form.
• Name (required) — The label buyers see for this option, e.g. Large / Red or 4x4 / SUV Tyre.
• Attributes — Click an attribute type button (Size, Color, Material, Flavor, Packaging, or Custom) to add that attribute. For Size you can pick standard values (XS, S, M, L, XL, 2XL, 3XL, One Size) or enter a custom value. Custom attributes let you define your own label and value (e.g. label: season, value: All-Season, Summer, Winter). You can add multiple attribute types to a single variant.

Click Next to proceed.

Step 2 — Pricing & details:

• Price override — Leave blank to use the parent product's price, or enter a specific price for this variant.
• Stock — Read-only. Stock is adjusted via the inventory system.
• Low stock threshold — You will be alerted when stock drops below this number.
• Show in store — Toggle off to hide this variant without deleting it.
• Variant image — Upload a photo specific to this variant (shown when the buyer selects it). Same format requirements as the main product image.

Click Next then review the summary and save.

The variants list shows each variant's name, attribute options, price, stock level, and status. Use the three-dot menu on any variant to View, Edit, or Delete it.

Click the three-dot menu on any product row to access:

• View — Full product detail page with all fields and images.
• Edit — Opens the same five-step form pre-filled. Changes go live immediately on save.
• Boost — Purchase a paid promotion to increase the product's visibility in search results.
• Delete — Permanently removes the product. Cannot be undone.

Click any order row to open its detail panel. The panel shows the buyer's name, contact number, delivery address, items ordered with quantities and prices, and the payment status. Use the action buttons to move the order through its lifecycle:

• Confirm — Accept the order. Buyer receives a notification.
• Mark Ready — Signal the order is packaged and ready.
• Dispatch — Mark as dispatched once it's with a courier.
• Mark Received — Close the order once delivered.
• Cancel — Cancel the order. Contact the buyer via chat first.

Click + Create Banner. The form has up to three steps depending on the banner type you choose.

Step 1 — Details:

• Banner Type — Choose one:
  • Standalone — A simple image banner. Buyers who click it are taken to your redirect link.
  • With Attachments — Links directly to specific businesses or products in your account. A third step (Attachments) is added to the form.
• Banner Name (required) — An internal label to identify this banner.
• Redirect Link — Where buyers land when they click the banner. Optional for Standalone banners.
• Start Date (required) — When the banner should go live.
• End Date (required) — When the banner campaign ends. Must be after the start date.
• Category — Auto-filled from your business category. Read-only.
• Subcategory — Optional. Determines which category page the banner appears on.

Click Create Banner to save Step 1 and advance.

Step 2 — Image: Upload your banner image. Drag and drop or click to browse. Recommended dimensions:

• Hero Banner: 1920 × 480 px (4:1 ratio)
• Top Business Banner: 1280 × 480 px (8:3 ratio)
• Formats: JPG, PNG, WebP — max 5 MB

Click Upload after selecting a file. You can skip image upload and add it later from the banner detail page.

Step 3 — Attachments (With Attachments banners only):

• Select a branch from the Branch dropdown and click Attach Business to link your business (or a specific branch) to the banner.
• Select a product from the Product dropdown and click Attach Product to link a product. You can attach multiple products — each appears as a card with a remove button.

Click Done to finish.

Each banner row shows its name, status, active date range, and image thumbnail. Use the three-dot menu to:

• View — Open the banner detail page to edit name, link, dates, image, or attachments.
• Activate — Make the banner live. Requires an uploaded image and the current date to be within the active period.
• Pause — Temporarily hide the banner without deleting it.
• Resume — Re-activate a paused banner.
• Promote — Purchase a paid boost to increase the banner's reach and placement.
• Archive — Move an ended campaign to the archive.
• Delete — Permanently remove the banner.

Your profile card shows your full name, email address, and phone number. Click Edit Profile to update any of these. Each contact field displays a verification badge:

• Email — Green Verified badge once OTP confirmed. Click Verify Email to trigger a 6-digit OTP sent to your email.
• Phone — Orange Unverified badge until confirmed. Click Verify Phone to trigger an SMS OTP to your number.

The verification modal walks you through sending and entering the OTP — the same 6-digit box flow used during registration.

Scroll to the Password & Security section and click Change Password. Enter your current password, then your new password twice to confirm. Your new password must be at least 6 characters.

Each active promotion card shows what is being boosted (business or product name), its current status, and the duration and cost of the package. Possible statuses:

• Pending payment — A promotion was created but payment has not yet been completed. An orange warning is displayed: "No payment has been initiated. Use the retry button below." Click Retry payment to trigger the M-Pesa STK push to your registered phone number.
• Active — The promotion is live and your listing is being boosted across the marketplace.
• Paused — The promotion has been temporarily suspended.

The History section lists all ended promotions. Each entry shows the promoted item (business or product), the boost type and duration, the cost, start and end dates, and the payment record. Use this as a reference when planning future boosts.

You can also start a new promotion directly from a product, banner, or business profile by clicking the Boost or Promote button on that item.