Language: EN | العربية
العربية

Complete Tenant User Guide

From Sign Up to Full Feature Usage

Welcome! This comprehensive guide will walk you through everything from signing up for a package to using all features in your tenant dashboard. Whether you're starting with a trial or purchasing a package directly, this guide covers every step in detail.

What is a Tenant?

A tenant is a user who signs up for a package to create and manage their own online store. Each tenant gets:

  • Their own subdomain (e.g., yourstore.keddily.com)
  • Full access to their dashboard
  • Ability to manage products, orders, customers, and more
  • Customizable storefront

Prerequisites

  • A valid email address
  • Internet connection
  • Credit/debit card (for paid packages)

Getting Started

Before you begin, make sure you have a valid email address and internet connection. For paid packages, you'll also need a credit or debit card ready for payment.

Sign Up Process

Step 1: Visit the Website

  1. Navigate to the main website (e.g., https://keddily.com)
  2. You'll see the homepage with available packages

Step 2: Choose a Package

  1. Browse the available packages on the homepage
  2. Each package shows:
    • Price: Monthly or yearly pricing
    • Features: List of included features
    • Term: Monthly, Yearly, or Lifetime
    • Trial Option: If available, a "Trial" button will appear

Step 3: Select Package Type

You have two options:

Option A: Start with Trial (if available)

Option B: Purchase Package Directly

  • Click the "Purchase" button on the package
  • Proceed to Package Purchase section

Trial Registration

Step 1: Access Trial Registration

  1. Click the "Trial" button on your chosen package
  2. You'll be redirected to the registration page

Step 2: Fill Registration Form

  1. Email Address: Enter your valid email
    • This will be used for login and notifications
    • Must be unique (not already registered)
  2. Password: Create a strong password
    • Minimum 8 characters
    • Use a mix of letters, numbers, and symbols
    • Confirm your password
  3. Agree to Terms: Check the box to accept Terms & Conditions and Privacy Policy
  4. Social Signup (Optional):
    • You can sign up using Google, Facebook, or other social providers
    • Click the social provider button
    • Authorize the application
    • Your email will be automatically filled

Step 3: Complete Registration

  1. Click "Continue" or "Sign Up" button
  2. You'll be redirected to the checkout page

Step 4: Enter Store Details

  1. Store Name (Username):
    • Choose a unique store name
    • This will be your subdomain: yourstorename.keddily.com
    • Only letters and numbers allowed
    • Cannot be changed later easily
  2. Personal Information:
    • First Name
    • Last Name
    • Phone Number
    • Address (optional)
  3. Category Selection (if required):
    • Select the category that best describes your business

Step 5: Confirm Trial

  1. Review all information
  2. Click "Confirm" or "Complete Registration"
  3. Your trial account will be created immediately
  4. You'll receive a confirmation email

Step 6: Access Your Dashboard

  1. You'll be automatically logged in
  2. Or log in using:
    • URL: https://keddily.com/user/login
    • Email and password you created

Package Purchase

Step 1: Access Purchase Page

  1. Click "Purchase" button on your chosen package
  2. You'll be redirected to the registration/checkout page

Step 2: Fill Registration Form

  1. Email Address: Enter your valid email
  2. Password: Create a strong password (minimum 8 characters)
  3. Confirm Password: Re-enter your password
  4. Agree to Terms: Check the Terms & Conditions box
  5. Click "Continue"

Step 3: Enter Billing Details

  1. Store Name (Username):
    • Choose a unique name for your store
    • This becomes your subdomain
    • Example: mystore → mystore.keddily.com
  2. Personal Information:
    • First Name
    • Last Name
    • Phone Number
    • Address
    • City
    • District/State
    • Postal Code
    • Country
  3. Category: Select your business category

Step 4: Apply Coupon (Optional)

  1. If you have a coupon code, enter it in the "Have a coupon?" field
  2. Click "Apply"
  3. The discount will be applied automatically
  4. Review the updated total

Step 5: Select Payment Method

  1. Choose your preferred payment gateway:
    • Paddle (for USD)
    • Paytabs (for EGP)
    • Stripe
    • PayPal
    • Other available gateways
  2. Review the Total Amount displayed

Step 6: Complete Payment

  1. Click "Confirm" or "Proceed to Payment"
  2. You'll be redirected to the payment gateway
  3. For Paddle (Inline Checkout):
    • Payment form appears on the same page
    • Enter your card details:
      • Card Number
      • Expiry Date
      • CVV
      • Cardholder Name
    • Click "Pay" or "Complete Payment"
  4. For Other Gateways:
    • Follow the gateway's instructions
    • Complete payment on their secure page
    • You'll be redirected back after payment

Step 7: Payment Confirmation

  1. After successful payment, you'll see a success message
  2. You'll receive a confirmation email
  3. Your account is now active
  4. You'll be automatically logged into your dashboard

Step 8: Access Your Dashboard

  1. You can access your dashboard at:
    • https://keddily.com/user/dashboard
  2. Or use the link provided in the confirmation email

Dashboard Overview

First Login

When you first log in, you'll see:

  • Welcome Message: Personalized greeting
  • Package Information: Your current package details
  • Quick Stats: Overview of your store
  • Quick Actions: Common tasks you can perform

Dashboard Sections

The dashboard is organized into main sections accessible from the left sidebar:

  1. Dashboard - Overview and statistics
  2. Website Analytics - Traffic and visitor data (if enabled)
  3. POS System - Point of Sale terminal (if enabled)
  4. Shop Management - Products, orders, customers
  5. Marketing - Coupons, promotions
  6. Appearance - Theme, pages, menus
  7. Settings - Store configuration
  8. And more...

Dashboard Feature

Accessing Dashboard

  • URL: https://keddily.com/user/dashboard
  • Click "Dashboard" in the left sidebar

What You'll See

  • Package Status: Active package information
  • Statistics Cards:
    • Total Products
    • Total Orders
    • Total Revenue
    • Pending Orders
  • Recent Activity: Latest orders and updates
  • Quick Links: Fast access to common tasks

Actions Available

  • View overall store performance
  • Monitor key metrics
  • Access quick actions

Website Analytics (If Enabled)

Accessing Analytics

  • Click "Website Analytics" in the sidebar
  • Submenu appears with options

Features Available

Analytics Dashboard

  • Overview:
    • Total visitors
    • Page views
    • Bounce rate
    • Average session duration
  • Charts: Visual representation of traffic
  • Time Range: Filter by date range

Top Pages

  • See which pages get the most traffic
  • Page view counts
  • Visitor engagement metrics

Device Analytics

  • Device Types: Desktop, Mobile, Tablet
  • Browser Information: Chrome, Safari, Firefox, etc.
  • Operating Systems: Windows, iOS, Android, etc.

Geographic Analytics

  • Visitor Locations: Countries and cities
  • Map Visualization: See where your visitors come from
  • Regional Statistics: Traffic by region

POS System (If Enabled)

Accessing POS

  • Click "POS System" in the sidebar
  • Select "POS Terminal"

Using the POS Terminal

Step 1: Add Products to Cart

  1. Search Products: Type product name or scan barcode
  2. Select Product: Click on the product
  3. Select Variant (if applicable): Choose size, color, etc.
  4. Set Quantity: Use +/- buttons or type quantity
  5. Add to Cart: Product appears in cart

Step 2: Apply Discounts (Optional)

  1. Coupon Code: Enter coupon if available
  2. Manual Discount: Apply percentage or fixed discount
  3. Wholesale Pricing: Automatic if quantity meets tier requirements

Step 3: Select Customer (Optional)

  1. Search Customer: Type customer name or phone
  2. Create New Customer: Add customer details on the fly
  3. Guest Checkout: Leave empty for walk-in customers

Step 4: Process Payment

  1. Review Total Amount
  2. Select Payment Method:
    • Cash
    • Card
    • Mobile Payment
  3. Enter Amount Received (for cash)
  4. Click "Complete Sale"

Step 5: Print Receipt (Optional)

  • Receipt automatically generated
  • Option to print or email receipt

Sales History

  • View all POS transactions
  • Filter by date, customer, payment method
  • View transaction details
  • Reprint receipts

POS Customers

  • Manage walk-in customers
  • Add customer information
  • View purchase history
  • Contact information

Shop Management

This is the core section for managing your online store.

Products

Categories

Creating a Category:

  1. Go to Shop Management → Products → Categories
  2. Click "Add New Category"
  3. Fill in:
    • Category Name: e.g., "Electronics"
    • Category Image: Upload image (optional)
    • Status: Active/Inactive
    • Featured: Mark as featured (optional)
  4. Click "Submit"

Editing a Category:

  1. Find the category in the list
  2. Click "Edit" icon
  3. Update information
  4. Click "Update"

Category Variations:

  • Set default variants for all products in category
  • Go to category → "Variations"
  • Add variant types (Size, Color, etc.)

Subcategories

Creating a Subcategory:

  1. Go to Shop Management → Products → Subcategories
  2. Click "Add New Subcategory"
  3. Fill in:
    • Subcategory Name
    • Parent Category: Select main category
    • Image (optional)
    • Status
  4. Click "Submit"

Labels

Creating Product Labels:

  1. Go to Shop Management → Products → Labels
  2. Click "Add New Label"
  3. Enter:
    • Label Name: e.g., "New", "Sale", "Featured"
    • Color: Choose label color
  4. Click "Submit"

Labels appear on products to highlight special status.

Variants

Creating Variant Types:

  1. Go to Shop Management → Products → Variants → Add Variant
  2. Enter:
    • Variant Name: e.g., "Size", "Color", "Material"
    • Options: Add options separated by commas
      • Example: "Small, Medium, Large" for Size
  3. Click "Submit"

Managing Variants:

  • View all variants: Variants → Variations
  • Edit existing variants
  • Delete unused variants

Adding Products

Step 1: Choose Product Type

  1. Go to Shop Management → Products → Items → Add Item
  2. Select product type:
    • Physical Product: Tangible items that need shipping
    • Digital Product: Downloadable files (PDF, software, etc.)

Step 2: Basic Information

  1. Product Name: Enter clear, descriptive name
  2. SKU: Stock Keeping Unit (optional, auto-generated if empty)
  3. Category: Select main category
  4. Subcategory: Select subcategory (optional)
  5. Labels: Select labels (New, Sale, etc.)

Step 3: Product Details

  1. Short Description: Brief overview (appears in listings)
  2. Description: Full product description
    • Use rich text editor
    • Add images, links, formatting
    • Include product features, specifications

Step 4: Pricing

  1. Current Price: Regular selling price
  2. Previous Price (optional): Show as "was $X, now $Y"
  3. Tax: Tax amount or percentage
  4. Stock Quantity: Available inventory
  5. Low Stock Alert: Set threshold for low stock warnings

Step 5: Product Images

  1. Main Image: Primary product image (required)
    • Click "Choose File"
    • Select image from computer
    • Recommended: 800x800px, square format
  2. Gallery Images: Additional product images
    • Upload multiple images
    • Drag to reorder
    • First image is main, others appear in gallery

Step 6: Product Variations (If Applicable)

  1. Click "Add Variation"
  2. Select variant type (Size, Color, etc.)
  3. For each combination:
    • Select options (e.g., "Small" + "Red")
    • Set Price (if different from base)
    • Set Stock Quantity
    • Upload Variant Image (optional)
  4. Click "Add Variation" for each combination

Step 7: Digital Product (If Digital)

  1. Upload File: Select downloadable file
  2. File Name: Name shown to customer
  3. Download Limit: Max downloads per purchase (optional)
  4. Expiry Days: File access expiration (optional)

Step 8: Shipping (Physical Products Only)

  1. Weight: Product weight
  2. Dimensions: Length, Width, Height
  3. Shipping Class: Standard, Express, etc.

Step 9: SEO Settings (Optional)

  1. Meta Title: SEO title
  2. Meta Description: SEO description
  3. Meta Keywords: Relevant keywords

Step 10: Status & Visibility

  1. Status: Active/Inactive
  2. Featured: Show on homepage
  3. Catalog Mode: Hide price/add to cart (if enabled)

Step 11: Save Product

  1. Click "Submit" to save
  2. Product is now live (if status is Active)

Editing Products:

  1. Go to Shop Management → Products → Items
  2. Find product in list
  3. Click "Edit" icon
  4. Update any information
  5. Click "Update"

Bulk Operations (If Enabled):

  • Bulk Import: Upload CSV file to add multiple products
  • Bulk Export: Download all products as CSV
  • Go to Products → Items → Bulk Operations

Managing Products

Product List View:

  • See all products in table format
  • Filter by: Status, Category, Featured
  • Search by name or SKU
  • Sort by: Name, Price, Stock, Date

Product Actions:

  • View: See product on frontend
  • Edit: Modify product details
  • Duplicate: Create copy of product
  • Delete: Remove product (with confirmation)
  • Variations: Manage product variations

Product Status:

  • Active: Visible to customers
  • Inactive: Hidden from storefront
  • Out of Stock: Automatically marked when stock = 0

Orders

Viewing Orders

All Orders:

  1. Go to Shop Management → Orders → All Orders
  2. See complete list of all orders
  3. Filter by:
    • Order Status
    • Date Range
    • Payment Status
    • Customer

Order Statuses:

  • Pending: New order, awaiting processing
  • Processing: Order being prepared
  • Completed: Order fulfilled and delivered
  • Rejected: Order cancelled/refunded

Order Details:

  1. Click on any order to view details
  2. See:
    • Customer Information
    • Order Items
    • Shipping Address
    • Billing Address
    • Payment Information
    • Order Timeline

Managing Orders

Update Order Status:

  1. Open order details
  2. Click "Update Status"
  3. Select new status:
    • Processing: When you start preparing order
    • Completed: When order is delivered
    • Rejected: If order needs to be cancelled
  4. Add Notes (optional)
  5. Click "Update"

Order Actions:

  • View Invoice: Download/print order invoice
  • Send Email: Notify customer (if email enabled)
  • Print Shipping Label: Generate shipping label
  • Add Note: Internal notes about order
  • Refund: Process refund (if enabled)

Order Filters:

  • Pending Orders: Orders awaiting action
  • Processing Orders: Orders being prepared
  • Completed Orders: Fulfilled orders
  • Rejected Orders: Cancelled orders

Order Reports

  1. Go to Shop Management → Orders → Order Reports
  2. View:
    • Sales by date range
    • Revenue statistics
    • Order trends
    • Top selling products
  3. Export reports as CSV/PDF

Customers

Viewing Customers

  1. Go to Shop Management → Customers
  2. See list of all registered customers
  3. View:
    • Customer Name
    • Email Address
    • Total Orders
    • Total Spent
    • Registration Date

Customer Details

  1. Click on customer to view details
  2. See:
    • Profile Information: Name, email, phone
    • Addresses: Shipping and billing addresses
    • Order History: All past orders
    • Account Status: Active/Inactive

Managing Customers

  • Edit Customer: Update customer information
  • View Orders: See all customer orders
  • Send Email: Contact customer directly
  • Deactivate: Disable customer account

Marketing Features

Advanced Coupons (If Enabled)

Creating Coupons

  1. Go to Shop Management → Coupons (or Marketing → Coupons)
  2. Click "Create New Coupon"
  3. Fill in:
    • Coupon Code: Unique code (e.g., "SAVE20")
    • Discount Type:
      • Percentage: e.g., 20% off
      • Fixed Amount: e.g., $10 off
    • Discount Value: Amount or percentage
    • Minimum Purchase: Minimum order amount (optional)
    • Maximum Discount: Cap on discount (optional)
    • Usage Limit: How many times coupon can be used
    • Per Customer Limit: Uses per customer
    • Valid From: Start date
    • Valid To: End date
    • Applicable Products:
      • All products
      • Specific categories
      • Specific products
    • Customer Eligibility:
      • All customers
      • New customers only
      • Specific customers
  4. Click "Create Coupon"

Managing Coupons

  • Active/Inactive: Toggle coupon status
  • Edit: Modify coupon details
  • View Usage: See how many times used
  • Delete: Remove coupon

Coupon Types

  • Store-wide: Applies to all products
  • Category-specific: Only certain categories
  • Product-specific: Only selected products
  • First-time Customer: New customers only

Wholesale Tiers (If Enabled)

Creating Wholesale Tiers

  1. Go to Shop Management → Wholesale Tiers
  2. Click "Create New Tier"
  3. Configure:
    • Tier Name: e.g., "Bulk Buyer"
    • Minimum Quantity: Minimum items to qualify
    • Discount Type: Percentage or Fixed
    • Discount Value: Discount amount
    • Applicable To:
      • All products
      • Specific categories
      • Specific products
    • Customer Groups: Who can use this tier
  4. Click "Create Tier"

How Wholesale Tiers Work

  • Automatically applied when customer adds items to cart
  • Best matching tier is selected
  • Discount shown in cart
  • Works with regular pricing

Managing Tiers

  • Edit: Modify tier settings
  • Toggle: Enable/disable tier
  • Delete: Remove tier
  • Priority: Higher quantity = better discount

Appearance & Customization

Theme Settings

Selecting Theme

  1. Go to Appearance → Theme Settings
  2. Browse available themes
  3. Click "Activate" on desired theme
  4. Preview changes before activating

Customizing Theme

  • Colors: Primary, secondary colors
  • Fonts: Font family and sizes
  • Layout: Page layout options
  • Header Style: Header design
  • Footer Style: Footer design

Home Page Customization

Hero Section

  1. Go to Pages → Home Page → Hero Slider
  2. Choose slider type:
    • Static Image: Single hero image
    • Slider: Multiple images with transitions
    • Product Slider: Featured products

Creating Hero Slider:

  1. Click "Create Slider"
  2. Upload images (recommended: 1920x800px)
  3. Add:
    • Title: Main heading
    • Subtitle: Supporting text
    • Button Text: Call-to-action
    • Button Link: Where button leads
  4. Set order/position
  5. Click "Submit"

Banner Section

  1. Go to Pages → Home Page → Banner Section
  2. Add promotional banners
  3. Upload banner image
  4. Add link (optional)
  5. Set display order

Features Section

  1. Go to Pages → Home Page → Features
  2. Add feature items:
    • Icon: Upload or select icon
    • Title: Feature name
    • Description: Feature description
  3. Display 3-6 features typically

Tab Section

  1. Go to Pages → Home Page → Tabs
  2. Create product tabs (e.g., "New Arrivals", "Best Sellers")
  3. Add products to each tab
  4. Products display in tabbed interface

Additional Sections

  1. Go to Pages → Home Page → Additional Sections
  2. Create custom sections:
    • Section Title
    • Content: Text, images, products
    • Layout: Choose layout style
  3. Position sections on homepage

Menu Builder

Creating Menus

  1. Go to Pages → Menu Builder
  2. Drag and drop menu items:
    • Pages: Link to pages
    • Categories: Link to product categories
    • Custom Links: External URLs
  3. Organize hierarchy:
    • Main items
    • Sub-items (drop-down)
  4. Click "Save Menu"

Menu Types

  • Main Menu: Primary navigation
  • Footer Menu: Footer links
  • Mobile Menu: Mobile navigation

Pages

Creating Custom Pages

  1. Go to Pages → Custom Pages
  2. Click "Add New Page"
  3. Fill in:
    • Page Title: e.g., "About Us"
    • Page Slug: URL-friendly name
    • Content: Full page content
    • Status: Published/Draft
  4. Click "Submit"

Managing Pages

  • Edit: Update page content
  • View: See page on frontend
  • Delete: Remove page
  • SEO: Set meta title, description

Settings & Configuration

Basic Settings

Site Information

  1. Go to Settings → Basic Settings
  2. Configure:
    • Store Name: Your business name
    • Store Logo: Upload logo
    • Favicon: Site icon
    • Email: Contact email
    • Phone: Contact phone
    • Address: Business address

Store Settings

  • Currency: Default currency
  • Language: Default language
  • Time Zone: Your timezone
  • Date Format: How dates display
  • Tax Settings: Tax rates and rules

Payment Gateways

Configuring Payment Methods

  1. Go to Settings → Payment Gateways
  2. Select payment methods to enable:
    • Stripe
    • PayPal
    • Paddle
    • Other gateways
  3. Enter API credentials for each
  4. Set as default (optional)
  5. Click "Save"

Payment Gateway Setup

Each gateway requires:

  • API Key: Provided by payment provider
  • Secret Key: Secure key from provider
  • Sandbox Mode: Test mode (enable for testing)
  • Webhook URL: For payment notifications

Shipping Settings

Shipping Zones

  1. Go to Settings → Shipping
  2. Create shipping zones:
    • Zone Name: e.g., "Domestic", "International"
    • Countries: Select countries in zone
    • Shipping Methods:
      • Flat Rate
      • Free Shipping
      • Weight-based
      • Price-based

Shipping Methods

  • Flat Rate: Fixed shipping cost
  • Free Shipping: Free for orders over amount
  • Weight-based: Cost by product weight
  • Local Pickup: Customer picks up

Email Settings

Email Configuration

  1. Go to Settings → Email Settings
  2. Configure:
    • SMTP Host: Mail server
    • SMTP Port: Port number
    • SMTP Username: Email username
    • SMTP Password: Email password
    • Encryption: SSL/TLS

Email Templates

  • Order Confirmation: Sent when order placed
  • Shipping Notification: Sent when order ships
  • Invoice: Order invoice email
  • Customize: Edit template content

Domains & URLs

Subdomain Information

  1. Go to Settings → Domains & URLs
  2. View your store URL:
    • Subdomain: yourstore.keddily.com
    • Full URL: https://yourstore.keddily.com

Custom Domain (If Available)

  1. Enter your custom domain
  2. Update DNS records as instructed
  3. Verify domain ownership
  4. SSL certificate auto-installed

Advanced Features

Support Ticket System (If Enabled)

Creating Support Tickets

  1. Go to Support Tickets → Create Ticket
  2. Fill in:
    • Subject: Brief description
    • Category: Select category
    • Priority: Low, Medium, High
    • Message: Detailed description
    • Attachments: Upload files (optional)
  3. Click "Submit Ticket"

Managing Tickets

  • View Tickets: See all your tickets
  • Reply: Respond to admin replies
  • Close: Mark ticket as resolved
  • Status: Open, In Progress, Closed

Refund Management (If Enabled)

Processing Refunds

  1. Go to Refunds
  2. View refund requests from customers
  3. Review refund details:
    • Order information
    • Refund reason
    • Amount requested
  4. Approve or Reject refund
  5. If approved, refund processed automatically

Refund Statistics

  • Total refunds processed
  • Refund amount
  • Pending refunds
  • Refund reasons

Inventory Management

Stock Management

  1. Go to Shop Management → Inventory
  2. View:
    • Low Stock: Products below threshold
    • Out of Stock: No inventory
    • Stock Alerts: Notifications
  3. Update stock quantities
  4. Set low stock thresholds

Stock Reports

  • Current stock levels
  • Stock movements
  • Reorder points
  • Export stock data

PWA (Progressive Web App)

What is PWA?

Progressive Web App (PWA) allows your customers to install your online store as a native-like app on their mobile devices and desktops. This provides:

  • App-like Experience: Your store works like a native mobile app
  • Offline Access: Customers can browse cached content even without internet
  • Home Screen Icon: Customers can add your store to their device home screen
  • Faster Loading: Cached resources load instantly
  • Push Notifications: Send notifications to customers (if enabled)
  • Better Engagement: Higher customer retention and return visits

Prerequisites

  • PWA feature must be included in your package
  • Your store must be accessible via HTTPS (required for PWA)
  • Service worker support in customer's browser

Accessing PWA Settings

  1. Go to Settings → PWA Settings (or Settings → Progressive Web App)
  2. If you don't see this option, PWA may not be included in your package
  3. Contact support to upgrade your package if needed

Configuring PWA Settings

Step 1: Basic App Information

  1. App Name:
    • Full name of your app (max 50 characters)
    • Example: "My Awesome Store"
    • This appears when customers install your app
  2. Short Name:
    • Shortened version (max 12 characters)
    • Example: "My Store"
    • Used when space is limited (e.g., home screen)
  3. Description:
    • Brief description of your app (max 200 characters)
    • Example: "Shop the latest fashion trends"
    • Helps customers understand what your app does

Step 2: App Colors

  1. Theme Color:
    • Primary color for your app (hex format: #007bff)
    • Used for browser UI elements (address bar, etc.)
    • Should match your store's brand color
    • Use color picker or enter hex code
  2. Background Color:
    • Background color shown during app launch (hex format: #ffffff)
    • Usually white or your brand color
    • Visible while app is loading

Step 3: App Icons

Icons are displayed when customers install your app on their device. You need to upload icons in multiple sizes:

  1. Master Icon (512x512px):
    • Upload a high-quality PNG image (512x512 pixels)
    • Square format recommended
    • This is the main icon - system may auto-generate other sizes
    • Should be clear and recognizable at small sizes
  2. Additional Icon Sizes (Optional but recommended):
    • 72x72px: Small devices
    • 96x96px: Standard small
    • 128x128px: Medium
    • 144x144px: Android
    • 152x152px: iOS (iPad)
    • 192x192px: Android home screen
    • 384x384px: Android splash
    • 512x512px: High-resolution (required)
  3. Icon Best Practices:
    • Use PNG format with transparency
    • Keep design simple and clear
    • Ensure logo/icon is centered
    • Test how it looks at small sizes
    • Avoid text in icons (use logo/symbol instead)

Step 4: Cache Strategy

Choose how your PWA handles offline content:

  1. Cache First (Recommended for most stores):
    • Serves cached content first, then checks network
    • Fastest loading for returning customers
    • Best for static content (product images, CSS, JS)
    • May show slightly outdated content until cache updates
  2. Network First:
    • Tries network first, falls back to cache if offline
    • Always shows latest content when online
    • Best for frequently changing content
    • Slightly slower than cache-first
  3. Stale While Revalidate:
    • Serves cache immediately, updates in background
    • Fast loading with fresh content
    • Best balance of speed and freshness
    • Recommended for product pages

Step 5: Enable/Disable PWA

  1. Status Toggle:
    • Turn PWA ON to activate it for your store
    • Turn OFF to disable (customers won't see install prompt)
    • Changes take effect immediately
  2. Offline Page (Optional):
    • Custom page shown when customer is offline
    • Can include store information, contact details
    • Helps maintain engagement even offline

Step 6: Save Settings

  1. Review all settings in the preview section
  2. Click "Update PWA Settings"
  3. Wait for success confirmation
  4. Settings are saved and active immediately

How Customers Install Your PWA

On Mobile Devices (Android)

  1. Customer visits your store in Chrome browser
  2. Browser shows "Add to Home Screen" banner
  3. Customer taps "Add" or "Install"
  4. App icon appears on home screen
  5. Customer can open app like a native app

On Mobile Devices (iOS - iPhone/iPad)

  1. Customer visits your store in Safari
  2. Taps the Share button (square with arrow)
  3. Scrolls down and taps "Add to Home Screen"
  4. Edits name if desired
  5. Taps "Add"
  6. App icon appears on home screen

On Desktop (Chrome/Edge)

  1. Customer visits your store
  2. Looks for install icon in address bar (or browser shows banner)
  3. Clicks "Install" button
  4. Confirms installation
  5. App opens in standalone window (no browser UI)
  6. App shortcut created in Start Menu (Windows) or Applications (Mac)

Testing Your PWA

Using Browser DevTools

  1. Open your store in Chrome
  2. Press F12 (or right-click → Inspect)
  3. Go to "Application" tab
  4. Check "Manifest" section:
    • Verify all icons are loaded
    • Check colors are correct
    • Ensure no errors
  5. Check "Service Workers" section:
    • Verify service worker is registered
    • Status should be "activated"
  6. Test "Offline" mode:
    • Check "Offline" checkbox
    • Refresh page
    • Store should still work (cached content)

Using Lighthouse (Chrome)

  1. Open your store in Chrome
  2. Press F12 → "Lighthouse" tab
  3. Select "Progressive Web App" checkbox
  4. Click "Generate Report"
  5. Review PWA score and recommendations
  6. Fix any issues highlighted

PWA Features Explained

Offline Functionality

  • Customers can browse previously visited pages offline
  • Cached product images, CSS, and JavaScript load instantly
  • New pages require internet connection
  • Cart and checkout require internet

Service Worker

  • Background script that handles caching
  • Automatically registered when PWA is enabled
  • Manages offline content
  • Updates automatically when you update PWA settings

App Manifest

  • JSON file that defines your app
  • Contains app name, icons, colors, start URL
  • Generated automatically from your settings
  • Accessible at: /manifest.json (or tenant-specific path)

Troubleshooting PWA

Install Prompt Not Showing

  1. Check PWA Status: Ensure PWA is enabled in settings
  2. Check HTTPS: PWA requires HTTPS (not HTTP)
  3. Check Browser: Use Chrome, Edge, or Safari
  4. Check Icons: Ensure at least 192x192 icon is uploaded
  5. Clear Cache: Clear browser cache and try again
  6. Check Manifest: Verify manifest.json is accessible

Icons Not Displaying

  1. Verify icons are uploaded correctly
  2. Check file format (must be PNG)
  3. Ensure correct dimensions (square, exact size)
  4. Check file permissions (should be publicly accessible)
  5. Clear browser cache
  6. Wait a few minutes for changes to propagate

Offline Mode Not Working

  1. Verify service worker is registered (check DevTools)
  2. Ensure cache strategy is set correctly
  3. Visit pages while online first (to cache them)
  4. Check browser console for errors
  5. Try unregistering and re-registering service worker

Changes Not Reflecting

  1. Clear browser cache
  2. Unregister service worker in DevTools
  3. Hard refresh page (Ctrl+Shift+R or Cmd+Shift+R)
  4. Wait a few minutes for cache to update
  5. Check manifest version/timestamp

Best Practices for PWA

  • Use High-Quality Icons: Clear, recognizable icons improve user experience
  • Match Brand Colors: Theme colors should match your store branding
  • Test on Multiple Devices: Ensure PWA works on Android, iOS, and desktop
  • Monitor Performance: Use Lighthouse to track PWA score
  • Keep Content Fresh: Choose appropriate cache strategy for your content
  • Promote Installation: Add banner or button encouraging customers to install
  • Update Regularly: Keep PWA settings updated with store changes

PWA Benefits for Your Business

  • Increased Engagement: Customers return more often
  • Faster Loading: Cached content loads instantly
  • Better Mobile Experience: App-like interface on mobile
  • Offline Access: Customers can browse even without internet
  • Home Screen Presence: App icon reminds customers of your store
  • Higher Conversion: Better UX leads to more sales
  • No App Store: No need to publish to Google Play or App Store

Additional Resources

  • PWA Documentation: Check official PWA documentation online
  • Browser Support: Chrome, Edge, Safari, Firefox all support PWA
  • Testing Tools: Use Chrome DevTools and Lighthouse for testing
  • Support: Contact support if you need help configuring PWA

Reports & Analytics

Sales Reports

  1. Go to Reports → Sales Report
  2. View:
    • Total sales
    • Sales by date range
    • Top selling products
    • Revenue trends
  3. Export as CSV/PDF

Product Reports

  • Best selling products
  • Low stock products
  • Products by category
  • Product performance

Customer Reports

  • Customer acquisition
  • Customer lifetime value
  • Repeat customer rate
  • Customer segments

Profile & Account

Profile Settings

  1. Go to Profile (click your name in sidebar)
  2. Update:
    • First Name
    • Last Name
    • Email
    • Phone
    • Photo: Upload profile picture
    • Address
  3. Click "Update Profile"

Change Password

  1. Go to Profile → Change Password
  2. Enter:
    • Current Password
    • New Password
    • Confirm New Password
  3. Click "Update Password"

Package Information

  • View current package
  • Package features
  • Expiry date
  • Upgrade options

Troubleshooting

Common Issues

Can't Log In

  1. Check Email/Password: Ensure correct credentials
  2. Reset Password: Use "Forgot Password" link
  3. Check Account Status: Ensure account is active
  4. Clear Browser Cache: Clear cookies and cache

Payment Not Processing

  1. Check Payment Gateway: Ensure gateway is configured
  2. Verify API Keys: Check API credentials are correct
  3. Test Mode: Disable sandbox/test mode for live payments
  4. Contact Support: If issue persists

Products Not Showing

  1. Check Status: Ensure product is "Active"
  2. Check Stock: Verify stock quantity > 0
  3. Check Category: Ensure category is active
  4. Clear Cache: Clear store cache

Orders Not Updating

  1. Refresh Page: Reload the page
  2. Check Status: Verify order status is correct
  3. Check Permissions: Ensure you have proper access
  4. Contact Support: If issue continues

Can't Access Feature

  1. Check Package: Verify feature is in your package
  2. Check Status: Ensure package is active
  3. Upgrade Package: May need higher tier package
  4. Contact Admin: Request feature access

Tips & Best Practices

Product Management

  • Use clear, descriptive product names
  • Add high-quality product images
  • Write detailed descriptions
  • Set appropriate prices
  • Keep stock updated
  • Use categories effectively

Order Management

  • Process orders promptly
  • Update order status regularly
  • Communicate with customers
  • Keep accurate records
  • Handle refunds professionally

Customer Service

  • Respond to inquiries quickly
  • Be professional and courteous
  • Resolve issues promptly
  • Follow up on orders
  • Build customer relationships

Marketing

  • Create attractive coupons
  • Use seasonal promotions
  • Email marketing campaigns
  • Social media integration
  • SEO optimization

Getting Help

Support Resources

  1. Documentation: Check this guide
  2. Support Tickets: Create ticket in dashboard
  3. Email Support: Contact support email
  4. Community Forum: Join user community

Contact Information

  • Support Email: Contact your platform administrator
  • Support Hours: Check with your platform administrator
  • Response Time: Varies by support plan

Conclusion

This guide covers the complete journey from sign-up to using all features in your tenant dashboard. Remember:

  1. Start Simple: Begin with basic features, then explore advanced options
  2. Test Thoroughly: Use test mode for payments before going live
  3. Keep Updated: Regularly check for new features and updates
  4. Stay Organized: Keep products, orders, and customers well-organized
  5. Monitor Performance: Use analytics to track your store's performance

Good luck with your online store!

Last Updated: January 2025 | Version: 1.0