Merchant Admin Panel Documentation

Complete guide to managing your online store

1. Overview

1.1 Introduction to the Merchant Admin Panel

The Merchant Admin Panel is your central hub for managing all aspects of your online store. This comprehensive platform allows you to:

  • View and manage orders
  • Add and edit products
  • Analyze sales performance
  • Manage your account and finances
  • Configure store settings

This documentation will guide you through all features and functionalities to help you efficiently manage your store.

1.2 Layout and Navigation Basics

The admin panel is divided into several main areas:

  1. Header - Contains the logo, navigation toggle, and user menu
  2. Sidebar - Main navigation menu with access to all sections
  3. Content Area - Displays the active section's content
Admin Panel Layout Visualization

Use the sidebar to navigate between different sections of your store management. The sidebar remains collapsible on mobile devices for optimal space usage.

1.3 Common Controls (Tabs, Filters, Search, Action Buttons)

Throughout the admin panel, you'll encounter several common control elements:

Tabs - Used to organize related content within a section. Click on different tabs to view different sets of information.

Filters - Allow you to narrow down displayed data based on specific criteria like date ranges, status, or categories.

Search - Located in various sections to help you quickly find specific orders, products, or other items.

Action Buttons - Perform specific operations like adding new items, editing, deleting, or exporting data.

Note: Most action buttons include icons for visual recognition and tooltips that appear when you hover over them.

1.4 Notifications and System Messages

The system uses toast notifications to provide feedback on your actions:

  • Green notifications indicate successful operations
  • Yellow notifications provide warnings or important information
  • Red notifications alert you to errors or issues that need attention

Notifications automatically disappear after a few seconds, but you can dismiss them manually by clicking the close button.

1.5 Logging In and Out

Logging In: Access your admin panel by visiting your store's admin URL and entering your credentials.

Logging Out: Click on your profile picture in the top right corner, then select "Logout" from the dropdown menu.

Tip: For security reasons, always log out when you're finished managing your store, especially on shared devices.

1.6 Understanding Modals and Pop-ups

Modals (pop-up windows) are used throughout the admin panel for:

  • Adding or editing products
  • Viewing order details
  • Updating order status
  • Confirming actions
  • Processing payments

To close a modal, you can either:

  1. Click the "X" button in the top right corner
  2. Click outside the modal content area
  3. Press the Escape key on your keyboard

2. Dashboard

2.1 Accessing the Dashboard

The Dashboard is the default landing page when you log into your Merchant Admin Panel. You can also access it at any time by:

  1. Clicking on the "Dashboard" option in the sidebar navigation menu
  2. Clicking on the logo in the header area

2.2 Dashboard Layout and Summary Cards

The Dashboard provides an at-a-glance overview of your store's performance with several key components:

Summary Cards - These four cards display crucial metrics:

  • New Orders - Number of new orders with trend indicator
  • Revenue - Total revenue with trend indicator
  • New Customers - Number of new customers
  • Low Stock Items - Products that need restocking
Dashboard Summary Cards Visualization

Each card shows the current value, a label describing what it represents, and a trend indicator showing whether the metric is increasing or decreasing compared to the previous period.

2.3 Time Filters (Today, Week, Month)

The Dashboard includes time filters that allow you to view your performance data for different time periods:

  • Today - Shows data for the current day only
  • This Week - Shows data for the current week (Sunday to Saturday)
  • This Month - Shows data for the current calendar month

To change the time period:

  1. Locate the "Period" filter in the top right area of the Dashboard
  2. Click on the dropdown menu
  3. Select your desired time period

The Dashboard will automatically update all charts and metrics to reflect the selected time period.

2.4 Sales Performance Chart

The Sales Performance chart visually represents your store's revenue over time, helping you identify trends and patterns.

This chart includes:

  • Daily, weekly, or monthly revenue data (depending on your selected time filter)
  • Interactive elements - hover over data points to see exact values
  • Period selector to switch between 7 days, 30 days, and 12 months views
Sales Performance Chart Visualization

Tip: Use the Sales Performance chart to identify your best-performing days or seasons, which can help with inventory planning and marketing campaigns.

2.5 Top Selling Products Chart

The Top Selling Products chart displays your best-performing products based on sales volume or revenue.

This chart helps you:

  • Identify your most popular products
  • Spot emerging trends in product popularity
  • Make informed decisions about inventory management
  • Plan promotions and marketing campaigns

The chart typically uses a bar graph format, with products on one axis and sales metrics on the other.

2.6 Customer Activity Chart

The Customer Activity chart provides insights into customer engagement with your store, including:

  • New customer registrations over time
  • Customer purchase frequency
  • Returning customer rates
  • Customer engagement metrics

This information is valuable for understanding customer behavior and loyalty, which can inform your customer retention strategies.

2.7 Using Dashboard Insights for Decision-Making

The Dashboard is designed to provide actionable insights that can help you make informed business decisions. Here's how to leverage this information:

  1. Inventory Management - Use the Low Stock Items alert to ensure you never run out of popular products
  2. Marketing Planning - Identify peak sales periods to time your promotions effectively
  3. Product Strategy - Analyze which products are performing best to inform future purchasing decisions
  4. Customer Acquisition - Track new customer numbers to measure the effectiveness of your marketing efforts
  5. Revenue Forecasting - Use historical sales data to predict future revenue and plan accordingly

Best Practice: Make it a habit to check your Dashboard at the beginning of each day to stay informed about your store's performance and address any urgent issues promptly.

3. Orders

3.1 Accessing the Orders Section

To access your orders management section:

  1. Click on the "Orders" option in the sidebar navigation menu (shopping bag icon)
  2. You'll be taken to the orders dashboard showing all recent orders

The orders section provides a comprehensive view of all customer purchases, with filtering and sorting capabilities to help you manage order fulfillment efficiently.

3.2 Filtering Orders (Status, Date, Search)

The orders section includes powerful filtering options to help you find specific orders:

Status Filter: Filter orders by their current status:

  • Pending - New orders that need processing
  • Processing - Orders being prepared for shipment
  • Shipped - Orders that have been dispatched
  • Completed - Orders successfully delivered
  • Cancelled - Orders that were cancelled

Date Filter: Filter orders by time period:

  • Today - Orders from the current day
  • This Week - Orders from the current week
  • This Month - Orders from the current month
  • All Time - View all orders regardless of date

Search: Use the search field to find orders by:

  • Order ID
  • Customer name
  • Customer email
  • Product names in the order

Tip: Combine multiple filters to narrow down your order list. For example, filter by "Pending" status and "Today" date to see all new orders that need immediate attention.

3.3 Overview of the Orders Table

The orders table displays all relevant information about each order in a structured format:

Columns in the orders table:

  • Order ID - Unique identifier for each order
  • Customer - Customer name and email address
  • Date - Order date and time
  • Items - Number of products in the order
  • Total - Order total amount
  • Status - Current order status with color coding
  • Actions - Available operations for each order

The table is sortable by clicking on column headers and paginated for easy navigation through large order volumes.

Note: Orders with urgent statuses (like Pending) may be highlighted to draw your attention to them.

3.4 Viewing Order Details

To view detailed information about a specific order:

  1. Locate the order in the orders table
  2. Click the "View" button (eye icon) in the Actions column
  3. A modal will open with comprehensive order details

Order details include:

  • Complete customer information (name, email, phone)
  • Delivery address and instructions
  • Detailed list of products with quantities and prices
  • Order subtotal, shipping cost, and total amount
  • Payment method and status
  • Order history and status timeline

Tip: Use the order details view to verify customer information before processing shipments, especially for first-time customers.

3.5 Updating the Status of an Order

Keeping order statuses updated is crucial for customer communication and inventory management:

To update an order status:

  1. Locate the order in the orders table
  2. Click the "Update Status" button (circular arrow icon) in the Actions column
  3. Select the new status from the dropdown menu
  4. Add optional notes about the status change
  5. Click "Confirm" to update the status

Status workflow:

  • PendingProcessing: Order is being prepared for shipment
  • ProcessingShipped: Order has been dispatched to the customer
  • ShippedCompleted: Order has been successfully delivered
  • Any status → Cancelled: Order has been cancelled (requires reason)

Note: Customers automatically receive notifications when their order status changes, so ensure status updates are accurate and timely.

3.6 Creating a Manual Order

You can create orders manually for phone orders, in-person sales, or other special circumstances:

To create a manual order:

  1. Click the "Create Order" button in the top right of the orders section
  2. Fill in customer information (or select existing customer)
  3. Add products to the order with quantities
  4. Set shipping method and address
  5. Apply discounts if applicable
  6. Select payment method and mark as paid if payment was collected
  7. Click "Create Order" to finalize

Use cases for manual orders:

  • Phone orders from regular customers
  • In-person sales at markets or events
  • Replacement orders for damaged items
  • Special pricing arrangements for wholesale customers

Important: Manual orders bypass the standard checkout process, so ensure all information is accurately entered, especially payment details.

3.7 Exporting Order Data

You can export order data for record-keeping, accounting, or analysis purposes:

To export orders:

  1. Apply any desired filters to narrow down the orders you want to export
  2. Click the "Export" button in the top right of the orders section
  3. Select export format (CSV, Excel, or PDF)
  4. Choose date range for the export
  5. Select which data columns to include
  6. Click "Export" to generate and download the file

Export formats and their uses:

  • CSV - For data analysis in spreadsheet software or custom systems
  • Excel - For accounting and reporting with formatted tables
  • PDF - For printing or sharing with team members

Tip: Regularly export order data for backup purposes, especially before performing system updates or making significant changes to your product catalog.

3.8 Managing Large Order Volumes

During peak seasons or sales events, you may need to process large volumes of orders efficiently:

Strategies for managing high order volumes:

  • Use status filters to focus on orders that need immediate attention
  • Batch process orders with similar characteristics (same shipping method, etc.)
  • Use the bulk update feature to change statuses for multiple orders at once
  • Print shipping labels in batches to streamline fulfillment
  • Set up automated status updates for common workflow steps

Bulk operations:

  1. Select multiple orders using the checkboxes in the first column
  2. Click the "Bulk Actions" button that appears
  3. Choose the operation to perform (update status, print labels, export selected)
  4. Confirm the action to apply it to all selected orders

Note: During high-volume periods, consider temporarily disabling certain complex product options or variants that may slow down order processing.

3.9 Best Practices for Order Fulfillment

Efficient order fulfillment is key to customer satisfaction and business success:

Fulfillment best practices:

  • Process orders daily - Aim to process new orders within 24 hours of receipt
  • Communicate proactively - Send shipping confirmations and tracking information promptly
  • Standardize packaging - Create consistent packaging processes to reduce errors
  • Verify addresses - Double-check delivery addresses before shipping, especially for international orders
  • Handle exceptions promptly - Address shipping delays, out-of-stock items, and other issues immediately

Creating an efficient fulfillment workflow:

  1. Check for new orders first thing each business day
  2. Print picking lists organized by product location in your warehouse
  3. Batch orders going to similar destinations for shipping discounts
  4. Update order statuses immediately after processing each stage
  5. Conduct regular audits to ensure inventory accuracy

Pro Tip: Implement a "fulfillment by time" system where you prioritize orders based on service level agreements (e.g., same-day shipping for orders placed before a certain time).

4. Products

4.1 Accessing the Products Section

To access your product management section:

  1. Click on the "Products" option in the sidebar navigation menu (box icon)
  2. You'll be taken to the products dashboard showing your product catalog

The products section allows you to manage your entire inventory, including adding new products, editing existing ones, organizing categories, and monitoring stock levels.

4.2 Adding a New Product

Adding new products to your catalog is a straightforward process with these steps:

4.2.1 Selecting Category

Start by selecting an appropriate category for your product:

  1. Click the "Add Product" button
  2. In the category dropdown, select the main category that best fits your product
  3. Categories help organize your catalog and improve customer browsing experience

4.2.2 Selecting Sub-category

After selecting a main category, choose a sub-category:

  1. The sub-category dropdown will populate based on your main category selection
  2. Select the most specific sub-category available
  3. If no suitable sub-category exists, choose the most relevant option or contact support to add new categories

4.2.3 Selecting Brand

Specify the product brand:

  1. Select the brand from the dropdown menu if it exists
  2. If the brand isn't listed, choose "Other" and enter the brand name in the field that appears
  3. Consistent brand naming helps customers find all products from a specific manufacturer

4.2.4 Selecting Product Class

Product classes provide additional specification:

  1. Based on your category and sub-category selection, appropriate classes will be available
  2. Select the class that most accurately describes your product
  3. Classes help with filtering and product comparisons

4.2.5 Adding Product Name and Description

Create compelling product titles and descriptions:

  1. Product Name: Use clear, descriptive names that include key features and specifications
  2. Description: Provide detailed information about the product, including features, benefits, and usage instructions
  3. Use bullet points for easy scanning of key features
  4. Include relevant keywords for better search visibility

4.2.6 Adding Features

Highlight key product features:

  1. Click "Add Feature" to create a new feature bullet point
  2. Enter concise, benefit-oriented features
  3. Focus on what makes the product unique or valuable to customers
  4. Use consistent formatting for similar products

4.2.7 Adding Variants (Colors, Sizes, etc.)

For products with options like size or color:

  1. Toggle the "This product has variants" option
  2. Add variant types (e.g., Color, Size)
  3. For each variant type, add the available options
  4. Specify additional price for variants if applicable
  5. Set stock levels for each variant combination

4.2.8 Uploading Product Images

High-quality images are essential for product presentation:

  1. Click the image upload area or drag and drop image files
  2. Upload multiple images to show different angles and details
  3. The first image will be the primary product image
  4. Use high-resolution images with clean backgrounds
  5. Include images that show scale, details, and product in use
  6. You can also upload product videos for enhanced presentation

4.3 Filtering Products (Category, Status, Search)

Efficiently manage your product catalog using filters:

Category Filter: View products in specific categories or sub-categories

Status Filter: Filter by Active, Inactive, or Low Stock status

Search: Find products by name, SKU, description, or other attributes

Tip: Use the Low Stock filter regularly to identify products that need replenishment before they sell out completely.

4.4 Viewing a Product

View complete product details:

  1. Locate the product in the products table
  2. Click the "View" button (eye icon) in the Actions column
  3. A modal will open with all product information, images, and variants

The product view shows how customers will see the product, including all images, descriptions, pricing, and availability.

4.5 Editing Product Information

Update product details as needed:

  1. Locate the product in the products table
  2. Click the "Edit" button (pencil icon) in the Actions column
  3. Update any product information in the edit form
  4. Click "Save Changes" to update the product

Common reasons to edit products:

  • Updating pricing or discounts
  • Adjusting stock quantities
  • Adding new images or improving descriptions
  • Correcting errors in product information
  • Adding new variants or options

4.6 Hiding / Deactivating a Product

Temporarily remove products from your store without deleting them:

  1. Locate the product in the products table
  2. Click the status toggle button (eye icon) in the Actions column
  3. Confirm the status change

Reasons to deactivate products:

  • Temporarily out of stock but planning to restock
  • Seasonal products out of season
  • Products undergoing updates or changes
  • Testing customer interest before full launch

Note: Deactivated products are not visible to customers but remain in your admin panel for easy reactivation.

4.7 Deleting a Product

Permanently remove products from your catalog:

  1. Locate the product in the products table
  2. Click the "Delete" button (trash icon) in the Actions column
  3. Confirm the deletion in the confirmation dialog

Warning: Product deletion is permanent and cannot be undone. Consider deactivating products instead if you might want to restore them later.

Before deleting a product, ensure:

  • There are no pending orders containing the product
  • The product is not part of any active bundles or promotions
  • You have exported any needed product data for records

4.8 Exporting Product Data

Export your product catalog for analysis, backup, or migration:

  1. Apply any desired filters to narrow down products
  2. Click the "Export" button in the top right
  3. Select export format (CSV, Excel)
  4. Choose which product fields to include
  5. Click "Export" to generate and download the file

Common uses for product exports:

  • Inventory analysis and planning
  • Migrating to a new platform
  • Creating offline backups
  • Generating printed catalogs or price lists

4.9 Managing Stock and Inventory Alerts

Effective inventory management prevents stockouts and overstocking:

Setting up inventory alerts:

  1. Edit a product and navigate to the inventory section
  2. Set a "Low Stock Threshold" - the quantity at which you want to be notified
  3. Save the changes

Managing inventory:

  • Regularly check the "Low Stock" filter to identify products needing restocking
  • Update stock quantities as you receive new inventory
  • Use the bulk edit feature to update multiple products at once
  • Set products to "Out of Stock" status when inventory is depleted

Tip: Implement a regular inventory audit schedule (weekly or monthly) to ensure physical stock matches your system records.

4.10 Best Practices for Catalog Organization

A well-organized product catalog improves customer experience and operational efficiency:

Catalog organization strategies:

  • Create logical categories and subcategories that mirror how customers search for products
  • Use consistent naming conventions for similar products
  • Implement a standardized SKU system for easy inventory management
  • Use product tags for cross-category filtering and search
  • Regularly review and prune outdated or underperforming products
  • Organize products by season, collection, or theme when applicable

Optimizing product listings:

  1. Use high-quality, multiple-angle product images
  2. Write clear, detailed product descriptions with specifications
  3. Highlight key features and benefits
  4. Include sizing charts, compatibility information, or usage guides where helpful
  5. Optimize product titles for search with relevant keywords

Pro Tip: Use the "Featured" product option to highlight your best-selling or highest-margin products in prominent positions on your storefront.

5. Analytics

5.1 Accessing the Analytics Section

To access your store analytics:

  1. Click on the "Analytics" option in the sidebar navigation menu (chart icon)
  2. You'll be taken to the analytics dashboard with performance overview

The analytics section provides data-driven insights into your store's performance, customer behavior, and sales trends to help you make informed business decisions.

5.2 Analytics Overview Page

The analytics overview presents key metrics at a glance:

Summary cards showing:

  • Total Revenue - Overall sales performance
  • Total Orders - Number of transactions
  • New Customers - Customer acquisition rate
  • Store Visits - Traffic volume to your store

Interactive charts including:

  • Revenue by Category - Sales distribution across product categories
  • Customer Acquisition - New vs. returning customer trends
  • Product Performance - Best-selling products and revenue contributors

Tip: Check your analytics overview daily to monitor store health and identify any significant changes that might need attention.

5.3 Time Period Filters (7 Days, Month, Quarter, Year)

Analyze performance across different time periods:

Available time filters:

  • Last 7 Days - Short-term trends and recent performance
  • This Month - Current monthly performance
  • This Quarter - Seasonal trends and quarterly planning
  • This Year - Annual performance and year-over-year comparisons

Comparing time periods:

  1. Select a time period from the dropdown filter
  2. All charts and metrics will update to reflect the selected period
  3. Use the comparison feature to view performance against previous period

Note: Some metrics may require sufficient data history to display accurately for longer time periods.

5.4 Revenue Summary and Charts

Detailed analysis of your store's revenue performance:

Revenue metrics:

  • Total Revenue - Gross sales amount
  • Average Order Value - Revenue per transaction
  • Revenue Trend - Growth or decline compared to previous period

Revenue charts:

  • Daily/Weekly/Monthly Revenue Trends - Visual representation of sales over time
  • Revenue by Channel - Sales distribution across different acquisition channels
  • Revenue by Location - Geographic distribution of sales

Tip: Look for patterns in your revenue charts—certain days of the week or times of year may consistently perform better, which can inform your marketing and promotion planning.

5.5 Orders Summary and Charts

Analysis of order volume and transaction patterns:

Order metrics:

  • Total Orders - Number of transactions
  • Conversion Rate - Percentage of visitors who make a purchase
  • Abandoned Cart Rate - Percentage of started but not completed purchases

Order charts:

  • Orders Over Time - Order volume trends
  • Order Status Distribution - Proportion of orders at each fulfillment stage
  • Average Order Value Distribution - Range of transaction values

5.6 Customer Acquisition and Behavior Reports

Understand how customers find and interact with your store:

Acquisition metrics:

  • New vs. Returning Customers - Customer loyalty metrics
  • Acquisition Channels - Where your customers come from (organic, social, direct, etc.)
  • Customer Lifetime Value - Long-term value of acquired customers

Behavior reports:

  • Time on Site - Engagement duration
  • Pages per Session - Depth of site exploration
  • Device Usage - Desktop vs. mobile shopping patterns

Tip: Focus your marketing efforts on acquisition channels that bring in customers with the highest lifetime value, not just the most visitors.

5.7 Product Performance Insights

Identify your best-performing products and categories:

Product performance metrics:

  • Units Sold - Volume of each product sold
  • Revenue Contribution - Percentage of total revenue from each product
  • Profit Margin - profitability of each product
  • Sales Velocity - How quickly products sell

Using product performance data:

  1. Identify best-sellers to ensure adequate stock levels
  2. Discover underperforming products that may need promotion or discontinuation
  3. Spot product combinations frequently purchased together
  4. Identify seasonal trends for specific products

5.8 Category-wise Revenue Distribution

Understand which product categories drive your business:

Category analysis:

  • Revenue by Category - Sales distribution across your catalog
  • Category Growth Trends - Which categories are growing or declining
  • Category Profitability - Margin analysis by category

Strategic applications:

  1. Allocate marketing budget to high-performing categories
  2. Identify opportunity areas where category performance lags behind market trends
  3. Optimize inventory investment based on category performance
  4. Plan category expansions or reductions based on performance data

5.9 Exporting Analytics Reports

Export analytics data for external analysis or reporting:

Export options:

  1. Select the data you want to export using filters
  2. Click the "Export Report" button
  3. Choose export format (CSV, Excel, PDF)
  4. Select specific metrics to include
  5. Set date range for the exported data
  6. Click "Export" to generate and download the report

Common use cases for exported reports:

  • Financial reporting and accounting
  • Investor or stakeholder updates
  • External data analysis in specialized tools
  • Historical performance archives

5.10 Using Analytics for Business Decisions

Transform data into actionable business intelligence:

Data-informed decision making:

  • Inventory Planning - Use sales velocity data to optimize stock levels
  • Marketing Allocation - Direct budget to highest-performing channels
  • Product Strategy - Expand winning products and categories
  • Pricing Optimization - Test and refine pricing based on demand elasticity
  • Customer Retention - Identify and nurture high-value customer segments

Creating an analytics routine:

  1. Schedule regular analytics review sessions (weekly, monthly)
  2. Establish key performance indicators (KPIs) to track
  3. Set up automated reports for routine monitoring
  4. Create dashboards for different team members based on their needs
  5. Use data to inform both tactical day-to-day decisions and long-term strategy

Pro Tip: Don't just look at what happened (descriptive analytics); try to understand why it happened (diagnostic analytics) and what might happen next (predictive analytics) to stay ahead of trends.

6. Accounts

6.1 Accessing the Accounts Section

To access your financial accounts and settings:

  1. Click on the "Accounts" option in the sidebar navigation menu (wallet icon)
  2. You'll be taken to the accounts dashboard with balance overview

The accounts section allows you to manage your store's finances, including viewing balances, processing payouts, reviewing transactions, and managing your subscription.

6.2 The Balance Tab

The Balance tab provides an overview of your current financial status:

6.2.1 Viewing Available Balance

Your available balance represents funds ready for withdrawal:

  • Displayed prominently at the top of the Balance tab
  • Updated in real-time as sales are processed
  • Represents cleared funds after payment processing periods

6.2.2 Withdrawing Funds

Transfer funds from your store balance to your bank account:

  1. Click the "Withdraw" button
  2. Enter the amount you wish to withdraw
  3. Select your preferred payout method
  4. Confirm the withdrawal request
  5. Funds will be processed according to your payout schedule

6.2.3 Viewing Pending and Processing Payouts

Track the status of your fund transfers:

  • Pending Payments - Revenue from recent sales not yet available for withdrawal
  • Processing Payouts - Withdrawal requests being processed by payment providers
  • Each status shows the amount and expected completion time

6.2.4 Next Payout Date

View when your next scheduled payout will occur:

  • Based on your configured payout schedule
  • Displayed clearly in the balance summary
  • Automatic payouts occur on this date if your balance exceeds the threshold

6.3 The Transactions Tab

The Transactions tab provides a detailed record of all financial activities:

6.3.1 Viewing Transaction History

Access comprehensive records of all money movements:

  1. Click on the "Transactions" tab
  2. View all transactions in chronological order
  3. Each entry shows date, amount, description, and balance impact
  4. Use pagination or infinite scroll to navigate through history

6.3.2 Filtering Transactions (Type, Status, Date)

Narrow down transaction records using filters:

  • Type Filter - View sales, payouts, refunds, or adjustments
  • Status Filter - Filter by completed, pending, or failed transactions
  • Date Filter - View transactions from specific time periods
  • Combine multiple filters for precise record searching

6.3.3 Viewing Transaction Details

Access detailed information for specific transactions:

  1. Click on any transaction in the list
  2. View complete details including:
    • Transaction ID and reference numbers
    • Date and time of processing
    • Related order information (for sales)
    • Fee breakdowns
    • Net amount after fees

6.4 The Subscription Tab

Manage your store subscription plan and billing:

6.4.1 Viewing Current Subscription

Review your active subscription details:

  • Current plan name and features
  • Monthly or annual billing amount
  • Subscription start date
  • Next billing date
  • Plan utilization (if applicable)

6.4.2 Upgrading / Renewing Subscription

Change your subscription plan or renew expired subscriptions:

  1. Click "Upgrade" or "Renew" based on your needs
  2. Select from available plan options
  3. Choose billing cycle (monthly or annual)
  4. Review cost changes and new features
  5. Confirm the subscription change

6.4.3 Paying by M-Pesa

Process subscription payments using M-Pesa:

  1. Select M-Pesa as payment method
  2. Enter your M-Pesa phone number
  3. Confirm payment amount
  4. Check your phone for STK push prompt
  5. Enter your M-Pesa PIN to complete payment
  6. Payment confirmation will appear automatically

6.4.4 Paying by Card

Process subscription payments using credit/debit card:

  1. Select card payment option
  2. Enter card details (number, expiry, CVC)
  3. Provide cardholder name and billing address
  4. Review and confirm payment
  5. Payment is processed securely through encrypted connection

6.5 The Payouts Tab

Track and manage your earnings withdrawals:

6.5.1 Viewing Payout Requests

Monitor the status of your withdrawal requests:

  • All pending and processing payout requests are listed
  • Each entry shows request date, amount, and method
  • Estimated completion dates are provided
  • Filter by status to see specific request stages

6.5.2 Payout Status Updates

Understand the different payout statuses:

  • Requested - Withdrawal initiated but not yet processed
  • Processing - Request being handled by payment provider
  • Completed - Funds successfully transferred to your account
  • Failed - Transfer unsuccessful (details provided for resolution)

6.5.3 Tracking Completed Payouts

Review historical payout records:

  1. Use the status filter to view "Completed" payouts
  2. Search by date range to find specific payouts
  3. Export payout history for accounting purposes
  4. Match payout records with bank statements for reconciliation

6.6 Managing Payout Methods (Bank, M-Pesa)

Configure how you receive your earnings:

Adding payout methods:

  1. Navigate to Payout Settings in the Settings section
  2. Click "Add Payout Method"
  3. Select method type (Bank Transfer or M-Pesa)
  4. Provide required account details
  5. Verify the method if required (small test transaction)
  6. Set as default if desired

Bank account requirements:

  • Account holder name (must match your business registration)
  • Bank name and branch
  • Account number
  • Routing/Sort code (if applicable)

M-Pesa requirements:

  • Registered phone number
  • Account name matching M-Pesa registration

Note: Payout methods may require verification before first use, which can take 1-2 business days. Always ensure your payout information is accurate to avoid failed transfers.

7. Settings

7.1 Accessing the Settings Section

To access your store configuration settings:

  1. Click on the "Settings" option in the sidebar navigation menu (gear icon)
  2. You'll be taken to the settings dashboard with various configuration tabs

The settings section allows you to customize all aspects of your store operation, from basic information to payment processing and shipping configurations.

7.2 General Settings

Configure basic store information and appearance:

7.2.1 Store Name, Contact, and Address

Set up your basic business information:

  1. Store Name - Your business name as displayed to customers
  2. Contact Email - Official email for customer communications
  3. Phone Number - Customer service contact number
  4. Physical Address - Your business location (optional for online-only businesses)
  5. Business Hours - When customers can expect responses

7.2.2 Logo Upload and Branding

Customize your store's visual identity:

  1. Click the "Upload Logo" button in the appearance settings
  2. Select your logo file (recommended: PNG with transparent background)
  3. Adjust cropping if necessary
  4. Preview how it appears in different contexts
  5. Save changes to update your storefront

Logo specifications:

  • Format: PNG, JPG, or SVG
  • Size: Minimum 300×100 pixels
  • Aspect ratio: 3:1 works best for most layouts

7.3 Payment Settings

Configure how you accept customer payments:

7.3.1 Platform Payments vs External Gateway

Choose between integrated payment processing or external gateways:

  • Platform Payments - Use the built-in payment system
    • Simplified setup and management
    • Unified reporting across all sales
    • Automatic compliance with payment regulations
  • External Gateway - Connect your own payment provider
    • Use existing merchant accounts
    • Potentially lower transaction fees
    • More customization options

7.3.2 Setting up Payment Gateways

Configure external payment providers:

  1. Select "External Gateway" option
  2. Choose your payment provider from the list
  3. Enter API credentials from your payment provider account
  4. Configure specific settings for your provider
  5. Test the connection with a test transaction
  6. Enable the gateway for live transactions

Supported gateways typically include:

  • Pesapal
  • M-Pesa
  • Stripe
  • PayPal
  • Other regional providers

7.4 Payout Settings

Configure how and when you receive your earnings:

7.4.1 Selecting Payout Currency

Choose the currency for your earnings deposits:

  1. Select your preferred currency from the dropdown
  2. Consider your business expenses and banking needs
  3. Note that currency conversion fees may apply if different from sales currency
  4. Changes may take effect from the next payout cycle

7.4.2 Setting Payout Schedule

Determine how frequently you receive payments:

  • Daily - Receive earnings every business day
  • Weekly - Receive payments on a specific day each week
  • Monthly - Receive consolidated payment once per month
  • Manual - Initiate payments manually when desired

Consider your cash flow needs and banking preferences when choosing a schedule.

7.4.3 Defining Payout Thresholds

Set minimum amounts for automatic payouts:

  1. Enter the minimum balance required for automatic payout
  2. This prevents small, inefficient transfers
  3. Set a threshold that matches your cash flow needs
  4. Manual withdrawals can still be made below the threshold

7.5 Shipping Settings

Configure how you handle product delivery:

7.5.1 Enabling Shipping

Set up shipping options for your products:

  1. Toggle the "Enable Shipping" option
  2. Choose whether to offer shipping for all products or select ones
  3. Set up shipping methods (standard, express, etc.)
  4. Configure handling time for order preparation

7.5.2 Free Shipping Threshold

Offer free shipping based on order value:

  1. Toggle "Enable Free Shipping Threshold"
  2. Set the minimum order value for free shipping qualification
  3. Optionally exclude certain products or categories
  4. Promote the free shipping threshold to customers

7.5.3 Default Shipping Fee

Set baseline shipping costs:

  1. Enter a default shipping fee for orders
  2. This applies when no specific shipping rules match an order
  3. Consider your average shipping costs when setting this fee
  4. Use shipping zones for more precise pricing

7.6 Shipping Zones

Create customized shipping rules for different regions:

7.6.1 Adding a Zone

Create a new shipping zone:

  1. Click "Add Shipping Zone"
  2. Name the zone (e.g., "Nairobi", "Western Kenya")
  3. Select regions included in the zone
  4. Set shipping fees for the zone
  5. Optionally set delivery time estimates
  6. Save the zone configuration

7.6.2 Editing a Zone

Modify existing shipping zones:

  1. Locate the zone in the shipping zones list
  2. Click the "Edit" button for that zone
  3. Modify any settings (regions, fees, etc.)
  4. Save changes to update the zone

7.6.3 Deleting a Zone

Remove unnecessary shipping zones:

  1. Locate the zone in the shipping zones list
  2. Click the "Delete" button for that zone
  3. Confirm deletion in the prompt
  4. Orders that would have used this zone will fall back to default shipping

7.7 Theme Settings

Customize your store's visual appearance:

7.7.1 Primary, Secondary, and Accent Colors

Define your store's color scheme:

  1. Primary Color - Main brand color used for buttons and highlights
  2. Secondary Color - Supporting color for backgrounds and alternate elements
  3. Accent Color - Color for alerts, notifications, and special elements
  4. Use color picker or enter hex codes for precise color matching
  5. Preview changes before applying them live

7.7.2 Previewing and Saving Theme Changes

Test and implement visual changes:

  1. Use the theme preview panel to see how changes will look
  2. Toggle between desktop and mobile views
  3. Make adjustments until satisfied with the appearance
  4. Click "Save Theme" to apply changes to your live store
  5. Changes take effect immediately for all visitors

7.8 Social Settings

Connect your social media profiles to your store:

7.9 Saving Settings and Confirmations

Finalize and confirm your configuration changes:

Saving settings:

  1. After making changes, click the "Save Settings" button
  2. Some changes may require confirmation before applying
  3. A success message will confirm your settings were saved
  4. Some changes may take effect immediately while others may require cache clearing

Settings confirmation:

  • Critical changes (like payment or shipping settings) may require extra confirmation
  • Always review changes before finalizing
  • Test important changes in a controlled manner before full implementation

Tip: Export your settings configuration periodically as a backup. This allows you to quickly restore your preferred configuration if needed.

8. Notifications and Feedback

8.1 Understanding Success Messages (Green Toasts)

Green notifications indicate successful operations:

Common success messages:

  • "Order status updated successfully"
  • "Product added successfully"
  • "Settings saved successfully"
  • "Payout requested successfully"

Characteristics of success messages:

  • Green background color
  • Checkmark icon
  • Brief, clear description of the completed action
  • Auto-dismiss after a few seconds

Tip: Success messages confirm that your action was processed correctly. You can proceed with confidence after seeing these notifications.

8.2 Warning and Info Messages (Yellow/Blue Toasts)

Yellow and blue notifications provide important information:

Common warning messages:

  • "Low stock alert for [Product Name]"
  • "Subscription will renew in [X] days"
  • "Some orders need attention"

Common info messages:

  • "New feature available"
  • "System maintenance scheduled"
  • "Seasonal promotion opportunity"

Characteristics of warning/info messages:

  • Yellow or blue background color
  • Exclamation point or information icon
  • May require acknowledgment before disappearing
  • Often include additional actions or links

8.3 Error Messages (Red Toasts)

Red notifications alert you to problems that need attention:

Common error messages:

  • "Failed to process payout - insufficient funds"
  • "Error updating product - please try again"
  • "Connection error - changes not saved"
  • "Payment processing failed - check payment method"

Characteristics of error messages:

  • Red background color
  • Error or warning icon
  • Often include specific error codes or details
  • May persist until manually dismissed
  • Frequently include troubleshooting suggestions

Note: Error messages often include specific error codes that can be provided to support staff for faster resolution if you need assistance.

8.4 Best Practices for Troubleshooting

Effective troubleshooting minimizes downtime and frustration:

Systematic troubleshooting approach:

  1. Read the message carefully - Note specific error codes or instructions
  2. Check for simple solutions first - Refresh the page, check your internet connection
  3. Review recent changes - Did you recently modify settings or add new products?
  4. Search help documentation - Many common issues have documented solutions
  5. Contact support if needed - Provide specific error details for faster resolution

Preventative practices:

  • Keep your browser updated to the latest version
  • Clear your browser cache periodically
  • Use supported browsers (Chrome, Firefox, Safari, Edge)
  • Avoid making multiple changes simultaneously when possible
  • Test changes in a controlled manner before full implementation

Pro Tip: Take screenshots of error messages before dismissing them. These can be incredibly helpful for support staff if you need assistance resolving an issue.

9. Practical Scenarios

9.1 Withdrawing Sales Money

Withdrawing your earnings from sales:

Step-by-step withdrawal process:

  1. Navigate to Accounts → Balance tab
  2. Check your Available Balance (cleared funds ready for withdrawal)
  3. Click the "Withdraw" button
  4. Enter the amount to withdraw (or select "Full Balance")
  5. Select your preferred payout method (bank transfer, M-Pesa, etc.)
  6. Review the transaction details and fees
  7. Confirm the withdrawal request
  8. Note the estimated processing time (typically 1-3 business days)

Important considerations:

  • Some funds may be "pending" due to payment processing periods
  • Minimum withdrawal amounts may apply depending on your payout method
  • Transaction fees may be deducted from the withdrawal amount
  • Keep records of withdrawals for accounting and tax purposes

Tip: Set up automatic withdrawals based on a schedule or threshold to ensure regular cash flow without manual intervention.

9.2 Adding Multiple New Products

Efficiently expand your product catalog:

Batch product addition strategies:

  1. Prepare product information in advance - Use a spreadsheet to organize details
  2. Use consistent formatting - Standardize product titles, descriptions, and images
  3. Leverage duplicate features - Copy similar products and modify details
  4. Utilize bulk upload tools - Use CSV import for adding multiple products at once
  5. Set aside dedicated time - Batch process product additions for efficiency

CSV import process:

  1. Download the product template CSV file
  2. Fill in product details following the format guidelines
  3. Save the file as CSV (UTF-8 encoding)
  4. Use the import tool to upload your CSV file
  5. Map CSV columns to product fields
  6. Review the import preview for errors
  7. Execute the import and monitor progress
  8. Review imported products for accuracy

9.3 Updating Shipped Orders

Keep customers informed about their order status:

When to update order status to shipped:

  • After packages have been handed to the shipping carrier
  • When tracking numbers are available
  • Before the end of the business day for same-day shipping promises

Updating shipped orders in bulk:

  1. Filter orders by "Processing" status
  2. Select all orders that have been shipped
  3. Use the bulk action menu to update status to "Shipped"
  4. Add tracking numbers if available
  5. Confirm the status change

Adding tracking information:

  1. In the order details view, locate the shipping section
  2. Enter the tracking number provided by your shipping carrier
  3. Select the shipping carrier from the dropdown
  4. Save the tracking information
  5. Customers will automatically receive tracking notifications

Tip: Integrate with shipping carriers for automated tracking updates. This saves time and ensures customers receive timely notifications about their shipment progress.

9.4 Preparing for a Sales Campaign

Plan and execute successful sales promotions:

Pre-campaign preparation checklist:

  1. Inventory assessment - Ensure adequate stock of promoted products
  2. Pricing strategy - Set discount levels and sale prices
  3. Promotional materials - Prepare banners, email templates, and social content
  4. Website readiness - Test site performance under increased traffic
  5. Team preparation - Ensure staff are ready for increased order volume
  6. Shipping coordination - Arrange for additional shipping capacity if needed

Setting up sale prices in the system:

  1. Use the bulk edit feature to update prices for multiple products
  2. Set sale start and end dates for automatic price changes
  3. Create a dedicated sale category or collection for easy navigation
  4. Test the customer experience before launching the sale

Monitoring during the campaign:

  • Track sales performance in real-time using the analytics dashboard
  • Monitor inventory levels to avoid stockouts
  • Watch for technical issues or site performance problems
  • Be prepared to adjust strategies based on early results

9.5 Reviewing Daily Transactions

Establish a routine for daily financial oversight:

Daily review checklist:

  1. New orders - Process orders received since last review
  2. Payments received - Verify payments match order totals
  3. Payout status - Check status of pending and processed withdrawals
  4. Refunds processed - Review any refunds issued
  5. Subscription payments - Note any recurring billing activities
  6. Transaction discrepancies - Investigate any mismatches or errors

Using the transactions tab for daily review:

  1. Filter transactions by "Today" to see daily activity
  2. Export the daily transactions for record-keeping
  3. Compare transaction totals with your bank deposits
  4. Note any failed transactions that need attention

Reconciliation best practices:

  • Perform daily reconciliation to catch issues early
  • Keep detailed records of each day's transactions
  • Investigate discrepancies immediately rather than letting them accumulate
  • Use the notes field to document unusual transactions or resolutions

Pro Tip: Set aside a consistent time each day for transaction review, ideally at the beginning or end of your business day. This routine helps ensure financial accuracy and timely issue resolution.

10. Troubleshooting

10.1 Missing Items in Tables

When expected items don't appear in order or product tables:

Common causes and solutions:

  • Filters applied - Check if filters are hiding items
  • Pagination - Items may be on other pages
  • Search terms - Clear search field to see all items
  • Status settings - Inactive products won't appear in some views
  • Data sync delay - New items may take a moment to appear

Troubleshooting steps:

  1. Clear all filters and search terms
  2. Check different pages using pagination controls
  3. Verify the item exists in the system using global search
  4. Refresh the page to ensure data is current
  5. Check if items are hidden due to status settings

Note: Some tables have a default sort order that may place newer items at the end. Try sorting by different columns to locate missing items.

10.2 Withdrawal Errors

When payout requests fail or encounter issues:

Common withdrawal errors:

  • Insufficient funds - Requested amount exceeds available balance
  • Invalid bank details - Account information is incorrect or outdated
  • Bank processing issues - Temporary problems with banking systems
  • Threshold not met - Amount below minimum withdrawal requirement
  • Verification required - Additional identity confirmation needed

Resolving withdrawal issues:

  1. Check the error message for specific details
  2. Verify your available balance covers the withdrawal amount plus fees
  3. Confirm your bank account details are correct and current
  4. Ensure your account meets any minimum balance requirements
  5. Contact your bank to confirm they're not blocking the transaction
  6. If problems persist, contact support with specific error details

10.3 Payment Issues (M-Pesa / Card)

When customer payments fail or encounter problems:

M-Pesa specific issues:

  • Insufficient balance - Customer doesn't have enough funds
  • Transaction cancelled - Customer cancelled the payment request
  • Network issues - Temporary problems with mobile networks
  • Wrong PIN - Customer entered incorrect M-Pesa PIN

Card payment issues:

  • Declined card - Issuing bank rejected the transaction
  • Expired card - Customer's card has expired
  • AVS mismatch - Address verification failed
  • Insufficient funds - Card doesn't have available credit/balance

Addressing payment issues:

  1. Check the specific error code in the transaction details
  2. For M-Pesa: Ask customer to ensure sufficient balance and correct PIN
  3. For cards: Suggest customer contact their bank or use alternative payment method
  4. Retry the payment after a short time for temporary issues
  5. Implement alternative payment options to reduce checkout abandonment

10.4 Logo Upload Failures

When logo uploads don't work correctly:

Common upload issues:

  • File too large - Exceeds maximum file size limit
  • Wrong format - File type not supported
  • Dimensions too small - Image doesn't meet minimum size requirements
  • Corrupted file - File is damaged or incomplete
  • Browser issues - Browser extensions or settings blocking upload

Troubleshooting logo uploads:

  1. Check file size and compress if necessary
  2. Convert to supported format (PNG, JPG, SVG)
  3. Ensure image meets minimum dimension requirements
  4. Try a different browser to isolate browser-specific issues
  5. Clear browser cache and cookies
  6. Try uploading a different image to test if the issue is file-specific

Tip: For best results, use PNG format with transparent background, minimum 300px width, and file size under 500KB. These specifications ensure crisp display across all devices and faster loading times.

10.5 Incorrect Totals in Reports

When financial reports show unexpected or incorrect totals:

Potential causes:

  • Time zone differences - Reports based on UTC vs local time
  • Filter misapplication - Filters excluding relevant transactions
  • Data sync delays - Recent transactions not yet reflected in reports
  • Refunds or adjustments - Negative transactions affecting totals
  • Currency conversion - Exchange rate fluctuations affecting totals

Investigating report discrepancies:

  1. Verify the date range and time zone settings
  2. Check applied filters to ensure they're not excluding relevant data
  3. Export raw transaction data for the period to verify totals manually
  4. Look for large refunds or adjustments that might be affecting totals
  5. Confirm whether totals include or exclude taxes and fees
  6. Check if currency conversion rates are affecting international transactions

10.6 When to Contact Support

Identifying issues that require assistance from the support team:

Contact support for:

  • System outages - When the platform is completely inaccessible
  • Payment processing failures - Persistent issues with payment integration
  • Data discrepancies - Unexplained inconsistencies in financial reports
  • Feature malfunctions - Core features not working as expected
  • Security concerns - Suspected unauthorized access or data breaches
  • Bug reports - Persistent software errors affecting operations

Before contacting support:

  1. Document the issue with screenshots or screen recordings
  2. Note error messages exactly as they appear
  3. Record what you were doing when the issue occurred
  4. List steps you've already tried to resolve the issue
  5. Gather relevant order numbers, transaction IDs, or product SKUs

Providing effective support requests:

  • Be specific and detailed in your problem description
  • Include relevant account information but not sensitive passwords
  • Specify the urgency of the issue (critical, high, medium, low)
  • Note if the issue affects your ability to process orders or serve customers
  • Follow up if you don't receive a response within the expected timeframe

11. Quick Reference

11.1 Orders Key Actions

Essential order management tasks and how to perform them:

Action How To
View new orders Dashboard → Orders card or Orders section → Filter by "Pending" status
Process an order Orders → Click order → Update status to "Processing"
Mark order as shipped Orders → Click order → Update status to "Shipped" → Add tracking info
Create manual order Orders → Click "Create Order" → Fill in details
Export order data Orders → Apply filters → Click "Export" → Select format

Shortcut: Use keyboard shortcuts when available. Press '/' to focus on search fields, and 'Escape' to close modals quickly.

11.2 Products Key Actions

Essential product management tasks and how to perform them:

Action How To
Add new product Products → Click "Add Product" → Fill in details → Save
Edit product Products → Find product → Click "Edit" → Make changes → Save
Manage inventory Products → Filter by "Low Stock" → Edit products → Update quantities
Deactivate product Products → Find product → Click status toggle → Confirm
Bulk edit products Products → Select multiple products → Click "Bulk Actions" → Choose operation

11.3 Analytics Key Actions

Essential analytics tasks and how to perform them:

Action How To
View daily performance Analytics → Set time filter to "Today"
Check revenue trends Analytics → Sales Performance chart → Select time period
Identify best sellers Analytics → Product Performance section
Analyze customer acquisition Analytics → Customer Acquisition chart
Export reports Analytics → Click "Export Report" → Select format and data