Appearance

Shipping Methods Settings ​

The Shipping Methods Settings allow you to configure shipping options for your e-commerce store, including shipping rates, zones, delivery times, and free shipping thresholds.

Table of Contents ​

  1. Overview
  2. Accessing Shipping Settings
  3. Creating Shipping Methods
  4. Shipping Configuration
  5. Shipping Zones
  6. Managing Shipping Methods
  7. Shipping Calculations
  8. Best Practices

Overview ​

Features ​

  • ✅ Create multiple shipping methods
  • ✅ Set shipping costs (fixed or calculated)
  • ✅ Configure shipping zones
  • ✅ Set minimum/maximum order amounts
  • ✅ Free shipping thresholds
  • ✅ Weight and dimension limits
  • ✅ Estimated delivery times
  • ✅ Default shipping method
  • ✅ Tracking URL templates

Admin Routes ​

  • Shipping Methods: /admin/settings/shipping-methods
  • Create Method: /admin/settings/shipping-methods/create
  • Edit Method: /admin/settings/shipping-methods/{id}/edit

Accessing Shipping Settings ​

From Admin Panel ​

  1. Log in to admin panel
  2. Navigate to Settings → Shipping Methods
  3. Or go directly to: /admin/settings/shipping-methods

Permissions Required ​

  • Manage Settings: manage-settings permission

Creating Shipping Methods ​

Step 1: Access Create Page ​

  1. Go to Shipping Methods → Create New Method
  2. Or navigate to: /admin/settings/shipping-methods/create

Step 2: Basic Information ​

Shipping Method Title ​

  • Name of shipping method
  • Required field
  • Shown to customers
  • Example: Standard Shipping

Description ​

  • Brief description
  • Shown to customers
  • Example: Regular shipping with tracking (5-7 business days)

Step 3: Shipping Cost ​

Cost Type ​

Options:

  • Fixed Cost: Fixed amount regardless of order
  • Free: Free shipping
  • Calculated: Based on weight/distance (if supported)

Shipping Cost ​

Fixed Cost:

  • Enter amount
  • Example: $9.99
  • Applied to all orders (within limits)

Free Shipping:

  • Set cost to $0.00
  • Or enable free shipping threshold

Step 4: Order Amount Restrictions ​

Minimum Order Amount ​

  • Minimum order value required
  • Optional field
  • Example: $25.00
  • Method not available below this amount

Maximum Order Amount ​

  • Maximum order value allowed
  • Optional field
  • Example: $500.00
  • Method not available above this amount

Free Shipping Threshold ​

  • Order amount for free shipping
  • Optional field
  • Example: $75.00
  • Shipping becomes free when threshold met
  • Overrides shipping cost

Step 5: Shipping Zones ​

Zone Configuration ​

Available Zones:

  • Domestic: Within country
  • International: Outside country
  • Canada: Canada only
  • Europe: European countries
  • Asia: Asian countries
  • Custom: Define custom zones

Select Zones:

  1. Click Add Zone
  2. Select zone(s)
  3. Method available in selected zones
  4. Can select multiple zones

Zone Examples:

  • domestic - US only
  • canada - Canada only
  • international - Worldwide
  • domestic, canada - US and Canada

Step 6: Weight Limits ​

Weight Restrictions ​

Minimum Weight:

  • Minimum package weight
  • Optional field
  • Example: 0.5 lbs
  • Method not available below this weight

Maximum Weight:

  • Maximum package weight
  • Optional field
  • Example: 50 lbs
  • Method not available above this weight

Weight Units:

  • Pounds (lbs)
  • Kilograms (kg)

Step 7: Dimension Limits ​

Package Dimensions ​

Maximum Dimensions:

  • Length: Maximum length
  • Width: Maximum width
  • Height: Maximum height
  • Optional fields

Dimension Units:

  • Inches
  • Centimeters

Example:

  • Length: 36 inches
  • Width: 24 inches
  • Height: 24 inches

Step 8: Delivery Information ​

Estimated Delivery Days ​

  • Estimated delivery time
  • Optional field
  • Example: 5-7 business days
  • Shown to customers

Delivery Time Format ​

Options:

  • Business days
  • Calendar days
  • Hours
  • Custom text

Examples:

  • 5-7 business days
  • 2-3 days
  • 24-48 hours
  • Next day delivery

Step 9: Additional Settings ​

Status ​

  • Active: Method available in checkout
  • Inactive: Method hidden from checkout

Default Method ​

  • Set as Default: Pre-selected in checkout
  • Only one default method
  • Shown first to customers

Display Order ​

  • Order in checkout
  • Lower numbers appear first
  • Example: 1 = first, 2 = second

Icon ​

  • Upload shipping icon
  • Recommended size: 64x64px
  • Format: PNG, SVG
  • Shown in checkout

Step 10: Tracking Configuration ​

Tracking URL Template ​

  • Tracking URL pattern
  • Optional field
  • Use {tracking_number} placeholder
  • Example: https://tracking.example.com/{tracking_number}

How It Works:

  • When tracking number entered
  • URL generated automatically
  • Customers can track packages

Examples:

  • USPS: https://tools.usps.com/go/TrackConfirmAction?tLabels={tracking_number}
  • FedEx: https://www.fedex.com/fedextrack/?trknbr={tracking_number}
  • UPS: https://www.ups.com/track?tracknum={tracking_number}

Step 11: Save Method ​

  • Save: Create shipping method
  • Save & Add Another: Create and add another
  • Method appears in checkout (if active)

Shipping Configuration ​

Common Shipping Methods ​

Standard Shipping ​

Configuration:

  • Title: Standard Shipping
  • Cost: $9.99
  • Zones: Domestic, Canada
  • Delivery: 5-7 business days
  • Free Threshold: $75.00

Express Shipping ​

Configuration:

  • Title: Express Shipping
  • Cost: $19.99
  • Zones: Domestic
  • Delivery: 2-3 business days
  • Free Threshold: $150.00
  • Max Weight: 20 lbs

Overnight Shipping ​

Configuration:

  • Title: Overnight Shipping
  • Cost: $29.99
  • Zones: Domestic
  • Delivery: Next business day
  • Max Weight: 10 lbs

International Shipping ​

Configuration:

  • Title: International Shipping
  • Cost: $24.99
  • Zones: International
  • Delivery: 10-14 business days
  • Max Weight: 50 lbs

Free Shipping ​

Configuration:

  • Title: Free Shipping
  • Cost: $0.00
  • Zones: Domestic
  • Min Order: $100.00
  • Delivery: 5-7 business days

Shipping Zones ​

Zone Definitions ​

Domestic Zone ​

Includes:

  • Within your country
  • Usually lowest cost
  • Fastest delivery

Configuration:

  • Zone key: domestic
  • Countries: Your country only
  • Example: US only

International Zone ​

Includes:

  • All countries outside domestic
  • Usually higher cost
  • Longer delivery times

Configuration:

  • Zone key: international
  • Countries: All except domestic
  • Worldwide shipping

Regional Zones ​

Examples:

  • Canada: canada
  • Europe: europe
  • Asia: asia
  • Australia: australia

Custom Zones ​

Creating Custom Zones:

  1. Define zone in code/config
  2. Use zone key in shipping method
  3. Method available in that zone

Managing Shipping Methods ​

Shipping Method List ​

Access at: /admin/settings/shipping-methods

List Features ​

Search:

  • Search by title
  • Search by description
  • Real-time results

Filters:

  • Status: Active/Inactive
  • Zone: Filter by zone
  • Default: Show default only

Sorting:

  • By Title (A-Z, Z-A)
  • By Cost (Low to High)
  • By Order
  • By Status

Displayed Information ​

  • Title: Method name
  • Cost: Shipping cost
  • Zones: Available zones
  • Status: Active/Inactive
  • Default: Default badge
  • Order: Display order

Editing Methods ​

  1. Click Edit on method
  2. Make changes
  3. Click Update
  4. Changes saved

Toggling Status ​

Route: /admin/settings/shipping-methods/{id}/toggle-status

  1. Click Toggle Status button
  2. Status changes immediately
  3. Active ↔ Inactive

Setting Default ​

Route: /admin/settings/shipping-methods/{id}/set-default

  1. Click Set as Default
  2. Method becomes default
  3. Previous default unset
  4. Shown first in checkout

Deleting Methods ​

  1. Click Delete button
  2. Confirm deletion
  3. Warning: Cannot be undone
  4. Method removed
  5. Existing orders not affected

Bulk Operations ​

Bulk Delete ​

  1. Select multiple methods
  2. Click Bulk Actions → Delete
  3. Confirm deletion
  4. All selected methods deleted

Shipping Calculations ​

How Shipping is Calculated ​

Order Amount Check ​

  1. Check Minimum:

    • If order < minimum amount
    • Method not available
    • Skip to next method

  2. Check Maximum:

    • If order > maximum amount
    • Method not available
    • Skip to next method

  3. Check Free Threshold:

    • If order >= free threshold
    • Shipping cost = $0.00
    • Method available

Weight Check ​

  1. Calculate Total Weight:

    • Sum of all product weights
    • Check against limits

  2. Check Minimum Weight:

    • If total < minimum weight
    • Method not available

  3. Check Maximum Weight:

    • If total > maximum weight
    • Method not available

Zone Check ​

  1. Determine Customer Zone:

    • Based on shipping address
    • Match to zone

  2. Check Zone Availability:

    • If method available in zone
    • Show to customer
    • Otherwise hide

Final Cost ​

  1. Base Cost:

    • Fixed cost from method
    • Or calculated cost

  2. Apply Free Shipping:

    • If threshold met
    • Cost = $0.00

  3. Display to Customer:

    • Show final cost
    • Show delivery time
    • Show method details

Best Practices ​

Method Configuration ​

  1. Clear Naming:

    • Use descriptive titles
    • Include delivery time
    • Make it clear to customers

  2. Reasonable Costs:

    • Set competitive rates
    • Consider actual costs
    • Include handling fees

  3. Free Shipping Thresholds:

    • Encourage larger orders
    • Set realistic amounts
    • Consider profit margins

Zone Management ​

  1. Organize by Region:

    • Group similar zones
    • Use consistent naming
    • Document zone definitions

  2. Test Zone Availability:

    • Test with different addresses
    • Verify correct methods shown
    • Check zone calculations

Customer Experience ​

  1. Clear Information:

    • Show delivery times
    • Display costs clearly
    • Explain restrictions

  2. Multiple Options:

    • Offer different speeds
    • Provide price ranges
    • Include free option

  3. Transparency:

    • Show all available methods
    • Explain restrictions
    • Provide tracking info

Troubleshooting ​

Method Not Showing ​

Solutions:

  1. Check status (must be Active)
  2. Verify zone matches customer address
  3. Check order amount restrictions
  4. Verify weight/dimension limits
  5. Clear cache

Incorrect Cost ​

Solutions:

  1. Verify cost is set correctly
  2. Check free shipping threshold
  3. Verify order amount
  4. Check zone configuration
  5. Review calculation logic

Tracking Not Working ​

Solutions:

  1. Verify tracking URL template
  2. Check tracking number format
  3. Ensure {tracking_number} placeholder
  4. Test URL manually
  5. Check tracking service

Last Updated: [Date will be updated during final review]

Released under the MIT License.

Copyright © 2024 OmniSuite CMS