Checkout Delivery Intent – User Documentation

Table of Contents

↑ Back to top
  1. Introduction
  2. Installation
  3. Initial Setup
  4. Configuration Guide
  5. Understanding Automatic Dispatch Labels
  6. Using the Delivery Planning Dashboard
  7. Customer Experience
  8. Troubleshooting
  9. Frequently Asked Questions
  10. Getting Help

Introduction

↑ Back to top

What is Checkout Delivery Intent?

↑ Back to top

Checkout Delivery Intent is a WooCommerce extension that captures and validates customer delivery preferences during checkout. Unlike simple date pickers, it automatically validates whether delivery expectations are realistic based on your handling capacity, cutoff times, and business rules.

Key Benefits

↑ Back to top
  • Prevent unrealistic expectations – Validates delivery dates before orders are placed
  • Automatic dispatch planning – Orders labeled by urgency (Needs Review / Prepare Today / Dispatch Later)
  • Improve fulfillment efficiency – Know when customers expect delivery, not just when they ordered
  • Reduce support tickets – Stop “where’s my order?” questions from unrealistic timelines
  • Work with existing setup – No carrier integration or workflow changes required

Who Should Use This Plugin?

↑ Back to top

This plugin is ideal for:

  • Stores with handling/preparation time before shipping
  • Businesses offering local or regional delivery
  • Made-to-order or perishable product sellers
  • Merchants who need fulfillment planning visibility
  • Anyone tired of managing unrealistic delivery expectations

Installation

↑ Back to top

System Requirements

↑ Back to top

Before installing, verify your site meets these requirements:

  • WordPress 6.8 or higher (tested up to 6.9)
  • WooCommerce 8.0 or higher
  • PHP 8.1 or higher

To check your versions:

  1. WordPress: Go to Dashboard โ†’ Updates (shows current version)
  2. WooCommerce: Go to WooCommerce โ†’ Status โ†’ System Status
  3. PHP: Same location, look for “PHP Version”

If you don’t meet requirements:

  • Contact your hosting provider to upgrade PHP
  • Update WordPress/WooCommerce before installing this plugin

Installation Steps

↑ Back to top

Step 1: Download the Plugin

  • Find the checkout-delivery-intent.zip file from your purchase confirmation
  • Save it to your computer

Step 2: Upload to WordPress

  1. Log in to WordPress admin dashboard
  2. Navigate to Plugins โ†’ Add New
  3. Click Upload Plugin button at the top
  4. Click Choose File and select your ZIP file
  5. Click Install Now
  6. Wait for “Plugin installed successfully” message

Step 3: Activate the Plugin

  1. Click Activate Plugin
  2. You’ll see a success message
  3. Plugin is now active but disabled by default (this is intentional)

Step 4: Verify Installation

  1. Go to WooCommerce โ†’ Settings
  2. Look for Checkout Delivery Intent tab
  3. If you see it, installation was successful

Important Note:
The plugin activates in a DISABLED state for safety. No changes appear on your checkout until you configure and enable it in settings.


Initial Setup

↑ Back to top

Follow these steps to configure the plugin for first use. This takes about 5-10 minutes.

Step 1: Access Plugin Settings

↑ Back to top
  1. Go to WooCommerce โ†’ Settings
  2. Click the Checkout Delivery Intent tab
  3. You’ll see the settings page with an informational notice at the top

Step 2: Read the “Needs Review” Notice

↑ Back to top

At the top of settings, you’ll see an important notice explaining “Needs Review” orders:

Understanding “Needs Review” Orders:

Orders appear in “Needs Review” when there isn’t sufficient time between order placement and delivery date to complete handling and dispatch.

Example: With a 24-hour handling time and 4:00 PM daily cutoff, an order placed at 5:00 PM for next-day delivery cannot be fulfilled in time.

This is a KEY FEATURE – orders are automatically flagged when timelines are unrealistic.

Step 3: Leave “Enable Plugin” UNCHECKED (For Now)

↑ Back to top

At the very top of settings, you’ll see:

  • โ˜ Enable Plugin

Leave this UNCHECKED while you configure the other settings. You’ll enable it as the final step.

Step 4: Configure Handling Time

↑ Back to top

Handling Time (hours):

  • This is measured in HOURS (0-168 hours = 0 to 7 days)
  • It’s the time YOU need to prepare orders before dispatch
  • Default: 24 hours

Examples:

  • 12 hours = Half-day preparation time
  • 24 hours = One full day
  • 48 hours = Two days
  • 72 hours = Three days

How to set it:

  • Think about your typical order processing time
  • Include time for picking, packing, and preparing for shipment
  • Be realistic – it’s better to over-estimate than under-deliver

Step 5: Configure Cutoff Time

Daily Cutoff Time:

  • Format: HH:MM (24-hour format, like 15:00 for 3:00 PM)
  • Orders placed AFTER this time count as next business day
  • Default: 15:00 (3:00 PM)

Examples:

  • 12:00 = Noon cutoff (orders after noon count as tomorrow)
  • 15:00 = 3:00 PM cutoff
  • 17:00 = 5:00 PM cutoff

Why this matters:
If your warehouse closes at 5:00 PM, orders placed at 6:00 PM can’t start processing until next day.

How handling time and cutoff work together:

Handling Time: 24 hours
Cutoff: 15:00 (3 PM)

Order placed Monday 2:00 PM:
  - Within cutoff โ†’ Handling starts Monday
  - 24 hours later = Tuesday
  - Earliest delivery: Wednesday

Order placed Monday 4:00 PM:
  - After cutoff โ†’ Handling starts Tuesday  
  - 24 hours later = Wednesday
  - Earliest delivery: Thursday

Step 6: Set Delivery Windows

↑ Back to top

Minimum Delivery Days:

  • Earliest delivery after order placement
  • Range: 0-365 days
  • Default: 2 days
  • This ADDS to handling time

Maximum Delivery Days:

  • Latest delivery after order placement
  • Range: 1-365 days (must be โ‰ฅ minimum)
  • Default: 5 days

Example:

Min: 2 days, Max: 5 days

Customer places order Monday:
  - Earliest delivery: Wednesday (2 days out)
  - Latest delivery: Saturday (5 days out)
  - Customer can only select dates in this range

Step 7: Configure Business Days

↑ Back to top

Business Days Only:

  • โ˜‘ Checked (default) = Automatically exclude Saturday and Sunday
  • โ˜ Unchecked = Allow all days of the week

Recommendation: Leave checked unless you deliver on weekends.

Excluded Weekdays:

  • Multiselect field
  • Options: Sunday through Saturday
  • Use this to exclude ADDITIONAL days beyond Sat/Sun

Example use cases:

  • You only deliver Tue/Thu โ†’ Exclude Mon, Wed, Fri, Sat, Sun
  • You work 6 days (Mon-Sat) โ†’ Keep “Business Days Only” unchecked, exclude Sunday only

Step 8: Add Blackout Dates

↑ Back to top

Specific Excluded Dates:

  • Large text box
  • Format: YYYY-MM-DD, one per line
  • Use for: Holidays, closures, known shutdown dates

Example:

2026-12-25
2026-12-26
2027-01-01
2027-07-04

Tips:

  • Add national holidays
  • Add company closure dates
  • Add known delivery service disruptions
  • You can add/remove these anytime

Step 9: Time Selection (Optional Feature)

↑ Back to top

Allow Time Selection:

  • โ˜ Unchecked (default) = Date only
  • โ˜‘ Checked = Date AND time selection

When to enable:

  • You have specific delivery time windows
  • Customers need to schedule delivery times
  • You offer morning/afternoon slots

Time Slot Interval (minutes):

  • Only matters if time selection is enabled
  • Options: 30, 60, or 120 minutes
  • Default: 60 minutes

Examples:

  • 30 min = 9:00-9:30, 9:30-10:00, 10:00-10:30, etc.
  • 60 min = 9:00-10:00, 10:00-11:00, 11:00-12:00, etc.
  • 120 min = 9:00-11:00, 11:00-1:00, 1:00-3:00, etc.

Step 10: POS Orders (Advanced)

↑ Back to top

Include POS Orders:

  • โ˜ Unchecked (default) = POS orders excluded from planning
  • โ˜‘ Checked = POS orders included

What are POS orders?
Point-of-Sale orders are in-store purchases (not online orders).

Why excluded by default?
POS orders are typically immediate pickup, so they don’t need delivery planning.

When to enable:
Only if your POS workflow requires delivery scheduling (rare).

Step 11: Enable and Save

↑ Back to top

Now you’re ready to enable:

  1. Scroll back to top
  2. Check โ˜‘ “Enable Plugin”
  3. Scroll to bottom
  4. Click “Save Changes”
  5. You’ll see “Your settings have been saved”

The delivery date field now appears at checkout!


Configuration Guide

↑ Back to top

Understanding Handling Time vs. Cutoff Time

↑ Back to top

This is a common source of confusion. Here’s the difference:

Handling Time:

  • TIME needed to process order (measured in hours)
  • Starts when order is placed (or next business day if after cutoff)
  • Example: 24 hours = order needs 1 full day of processing

Cutoff Time:

  • WHEN orders stop counting for same-day processing
  • Affects when handling starts
  • Example: 15:00 = orders after 3 PM start processing tomorrow

They work together:

Scenario 1: Order at 2 PM, cutoff 3 PM, handling 24h
  โ†’ Within cutoff
  โ†’ Handling starts today at 2 PM
  โ†’ Handling ends tomorrow at 2 PM
  โ†’ Earliest delivery: Day after tomorrow

Scenario 2: Order at 4 PM, cutoff 3 PM, handling 24h
  โ†’ After cutoff
  โ†’ Handling starts tomorrow
  โ†’ Handling ends day after tomorrow
  โ†’ Earliest delivery: 3 days from now

Advanced Cutoff Scenarios

↑ Back to top

What if customer orders at 11:59 PM?

  • After cutoff โ†’ Counts as next business day
  • Plus your handling time
  • Plus minimum delivery window

What about weekends?

  • If “Business Days Only” is checked:
  • Friday 4 PM (after cutoff) โ†’ Starts Monday
  • Saturday/Sunday orders โ†’ Start Monday
  • Handling time counts only business days

Example with weekend:

Settings:
- Business Days Only: Yes
- Cutoff: 15:00
- Handling: 24 hours
- Min delivery: 2 days

Order placed Friday 4:00 PM:
  โ†’ After cutoff
  โ†’ Starts Monday (next business day)
  โ†’ Plus 24h handling = Tuesday
  โ†’ Plus 2 day minimum = Thursday
  โ†’ Earliest delivery: Thursday

Calculating Your Ideal Settings

↑ Back to top

Step 1: Know your actual processing time

  • Time to pick order
  • Time to pack
  • Time to prepare shipping label
  • Buffer for busy periods

Step 2: Know your daily schedule

  • When does order processing start? (e.g., 9 AM)
  • When does it end? (e.g., 5 PM)
  • Set cutoff before end time (e.g., 3 PM gives 2-hour buffer)

Step 3: Know your delivery capacity

  • How soon CAN you realistically deliver?
  • How far ahead do you want to accept orders?
  • Set min/max accordingly

Conservative is better than aggressive:

  • Over-promise = Disappointed customers
  • Under-promise = Delighted customers

Understanding Automatic Dispatch Labels

↑ Back to top

This is a CORE FEATURE of the plugin. Orders are automatically labeled based on fulfillment urgency.

Three Auto-Generated Labels

↑ Back to top

The plugin analyzes each order and assigns ONE of these labels:

1. HOLD (Needs Review)

What it means:
There is NOT enough time between order placement and customer’s expected delivery date to fulfill the order.

Example scenario:

Settings: 24h handling, 15:00 cutoff, business days only

Customer orders Friday 5:00 PM for Monday delivery:
  โ†’ After cutoff โ†’ Starts Monday
  โ†’ Plus 24h handling โ†’ Tuesday earliest
  โ†’ Customer expects Monday
  โ†’ IMPOSSIBLE โ†’ Labeled "Needs Review"

What to do:

  • Contact customer immediately
  • Explain the delay
  • Offer: Later delivery date OR refund
  • Update delivery date in order if customer agrees

Why this happens:

  • Customer doesn’t understand your handling time
  • Rush delivery request
  • Same-day delivery attempted after cutoff

2. PREPARE_TODAY (Prepare Today)

What it means:
This order needs to start processing TODAY to meet the delivery date.

Example scenario:

Settings: 24h handling, business days only

Customer orders Monday 10:00 AM for Wednesday delivery:
  โ†’ Within cutoff โ†’ Starts Monday
  โ†’ Plus 24h handling โ†’ Tuesday
  โ†’ Plus transit โ†’ Wednesday
  โ†’ FEASIBLE โ†’ Labeled "Prepare Today"

What to do:

  • Add to today’s fulfillment queue
  • Prioritize in picking/packing
  • Prepare for dispatch today or tomorrow

3. DISPATCH_LATER (Dispatch Later)

What it means:
This order is scheduled for future delivery – no immediate action needed.

Example scenario:

Customer orders Monday for Friday delivery:
  โ†’ Plenty of time
  โ†’ Can process Wed/Thu
  โ†’ Labeled "Dispatch Later"

What to do:

  • Schedule for appropriate preparation day
  • Don’t rush – you have time
  • Review later in the week

How Labels Are Calculated

↑ Back to top

The plugin does complex math automatically:

  1. Checks when order was placed
  2. Applies cutoff time rules
  3. Adds handling time
  4. Adds minimum delivery window
  5. Accounts for business days only
  6. Compares to customer’s selected date
  7. Assigns appropriate label

You don’t configure this – it’s automatic.


Using the Delivery Planning Dashboard

↑ Back to top

The dashboard is your main planning tool for viewing and organizing orders.

Accessing the Dashboard

↑ Back to top
  1. Go to WooCommerce โ†’ Checkout Delivery Intent in admin sidebar
  2. Dashboard loads if plugin is enabled
  3. If disabled, you’ll see a notice to enable it

Dashboard Layout

↑ Back to top

At the top:

Summary Cards – Three boxes showing:

  • Total Orders – All orders in selected date range
  • Prepare Today – Orders needing immediate action
  • Dispatch Later – Future scheduled orders

(Note: “Needs Review” count appears in its own section)

Filters Bar:

  • Date range dropdown (Today / Tomorrow / Next 7 Days / This Month)
  • Current date range display (e.g., “Showing: Feb 3 to Feb 10”)
  • Export CSV button
  • Print View button

Main Content:

Orders grouped by auto-generated label:

Needs Review (3 orders)
โ”œโ”€ Order #1234 - John Doe - $125.00 - Wed Feb 5
โ”œโ”€ Order #1235 - Jane Smith - $87.50 - Wed Feb 5  
โ””โ”€ Order #1236 - Bob Johnson - $234.00 - Thu Feb 6

Prepare Today (5 orders)
โ”œโ”€ Order #1240 - Mary Williams - $156.00 - Wed Feb 5
โ””โ”€ ...

Dispatch Later (12 orders)
โ””โ”€ ...

Using Date Range Filters

↑ Back to top

Available Filters:

  • Today – Orders with today’s delivery date only
  • Tomorrow – Tomorrow’s delivery dates
  • Next 7 Days – Default, shows upcoming week
  • This Month – All orders this calendar month

To change filter:

  1. Click dropdown
  2. Select new range
  3. Dashboard updates automatically

Current range shown:
“Showing: Feb 3, 2026 to Feb 10, 2026”

Understanding Order Information

↑ Back to top

For each order, you see:

  • Order number (clickable link)
  • Customer name
  • Order total
  • Delivery date
  • Delivery time (if time selection enabled)
  • Order status (Processing, Completed, etc.)

Clicking order number:

  • Opens full order details in new tab
  • You can edit order, change status, etc.
  • Delivery date shown in Order Meta section

Exporting Data

↑ Back to top

CSV Export:

  1. Click “Export CSV” button
  2. Downloads file immediately
  3. Respects current date filter

CSV Columns:

  • Order Number
  • Customer Name
  • Delivery Date
  • Delivery Time (if applicable)
  • Order Status
  • Dispatch Label

Use cases:

  • Share with warehouse team
  • Import into route planning software
  • Backup planning records
  • Send to logistics partners

Printing the Dashboard

↑ Back to top

Print View:

  1. Click “Print View” button
  2. Opens browser print dialog
  3. Simplified layout (no navigation, optimized spacing)

Tips:

  • Print by dispatch label for different teams
  • Use date filters to print daily sheets
  • Consider landscape orientation for wider view

Important Dashboard Limitations

↑ Back to top

The dashboard is READ-ONLY. It does NOT:

  • Modify order status (stays as Processing, Completed, etc.)
  • Change inventory levels
  • Send customer notifications
  • Create shipping labels
  • Trigger any automation
  • Integrate with carriers
  • It ONLY provides:
  • Planning visibility
  • Dispatch urgency labels
  • Order grouping by date
  • Export capabilities

Customer Experience

↑ Back to top

Understanding what customers see helps you provide better support and set proper expectations.

At Checkout

↑ Back to top

What customers see:

  1. Delivery Date Field
  • Appears in checkout form (after billing address area)
  • Label: “Preferred Delivery Date”
  • Placeholder: “Select date (earliest: Feb 5, 2026)”
  • Required: Yes (red asterisk)
  • Type: Date picker calendar
  1. Delivery Time Field (if you enabled time selection)
  • Appears below date field
  • Label: “Preferred Delivery Time”
  • Type: Dropdown with time slots
  • Options depend on your interval setting (30/60/120 min)

How the date picker works:

When customer clicks the date field:

  • Calendar opens
  • Grayed out dates = unavailable (past, excluded, outside window)
  • White dates = available (clickable)
  • Customer clicks available date
  • Date appears in field

If customer tries invalid date:

  • Error message shows
  • Explains why date is invalid
  • Examples:
  • “Date is too soon (minimum 2 days)”
  • “Selected date falls on excluded day”
  • “Please select a business day”

Validation Examples

↑ Back to top

Scenario 1: Date too soon

Today: Monday Feb 3
Customer tries: Tuesday Feb 4
Settings: Min 2 days
Result:  "Earliest delivery is Wednesday Feb 5"

Scenario 2: Weekend selected

Customer tries: Saturday Feb 8
Settings: Business days only
Result:  "Please select a business day (Monday-Friday)"

Scenario 3: Holiday selected

Customer tries: Dec 25
Blackout dates: 2026-12-25
Result:  "Selected date is unavailable"

Scenario 4: Valid date

Customer selects: Thursday Feb 6
Validation checks:
   In the future
   Within min/max window
   Not excluded
   Business day
Result:  Date accepted, checkout can proceed

In Order Confirmation

↑ Back to top

After successful order placement:

Confirmation Page:

  • Shows: “Delivery Date: Wednesday, February 5, 2026”
  • Shows: “Delivery Time: 2:00 PM – 3:00 PM” (if time enabled)
  • Listed with other order details

Confirmation Email:

  • Delivery preferences in order summary
  • Same format as website

My Account โ†’ Orders:

  • Customer can view order history
  • Delivery date shown for each order
  • Cannot self-modify after ordering

Customer Limitations

↑ Back to top

Customers CANNOT:

  • Change delivery date after ordering
  • See available time slots before selecting date
  • Choose dates outside your configured windows
  • Override validation rules

If customer needs to change date:

  • They must contact your support
  • You can manually change it from order edit screen
  • Update the _delivery_date meta field

Setting Customer Expectations

↑ Back to top

What you SHOULD communicate:

  • “Select your preferred delivery date”
  • “We’ll do our best to deliver on your selected date”
  • “Delivery date is subject to carrier availability”
  • “This is a preferred date, not a guarantee”

What you SHOULD NOT promise:

  • “Guaranteed delivery on exact date”
  • “Your order will definitely arrive on this date”
  • “Choose any date and we’ll meet it”

Why:
Delivery depends on factors outside your control (weather, carrier delays, etc.). The field captures INTENT, not absolute commitment.


Troubleshooting

↑ Back to top

Common Issues and Solutions

↑ Back to top

Issue: Delivery date field doesn’t appear at checkout

Possible causes and solutions:

1. Plugin not enabled

  • Go to WooCommerce โ†’ Settings โ†’ Checkout Delivery Intent
  • Check if “Enable Plugin” is checked
  • If unchecked, check it and save

2. Theme or plugin conflict

  • Test: Switch to Storefront or Twenty Twenty-Four theme temporarily
  • If field appears with default theme, your theme may need adjustment
  • Contact theme developer

3. Checkout blocks not updated

  • If using Block Checkout, ensure WooCommerce is version 8.0+
  • Go to Plugins โ†’ Update
  • Update WooCommerce if available

4. Cache not cleared

  • Clear site cache (if using caching plugin)
  • Clear browser cache (Ctrl+Shift+Delete)
  • Try in incognito/private window

5. JavaScript error

  • Open browser console (F12)
  • Look for red errors
  • Send screenshot to support if errors present

Issue: All dates are grayed out

Possible causes:

1. Handling time too long

  • Settings show: Handling time 168 hours (7 days)
  • Plus min delivery window
  • Earliest date might be 2+ weeks out
  • Solution: Reduce handling time to realistic value

2. No business days selected

  • Check “Business Days Only” is appropriate
  • Check “Excluded Weekdays” isn’t excluding everything
  • Solution: Ensure at least some days are available

3. All dates in blackout list

  • Check “Specific Excluded Dates”
  • Remove outdated dates
  • Solution: Clear old blackout dates

4. Delivery window impossible

  • Min delivery: 30 days
  • Max delivery: 5 days
  • (Max < Min = impossible)
  • Solution: Max must be โ‰ฅ Min

Issue: “Needs Review” orders appearing constantly

This is expected if:

  • Customer orders after cutoff for next-day delivery
  • Handling time is long relative to delivery expectation
  • Orders placed Friday for Monday delivery (with weekend exclusion)

Solutions:

  • Educate customers about lead times
  • Adjust min delivery window higher
  • Make cutoff time earlier
  • Consider disabling same-day/next-day selections

Not a bug – this is the plugin working correctly by flagging unrealistic orders.

Issue: Time selection not appearing

Checklist:

  1. Is “Allow Time Selection” checked in settings?
  2. Did you save after enabling it?
  3. Did you clear cache after saving?
  4. Are you looking at the right checkout (Block vs Classic)?

Solution:

  • Enable time selection
  • Save settings
  • Clear cache
  • Refresh checkout page

Issue: Customers can select past dates

This indicates a serious configuration issue:

Check timezone:

  • Go to Settings โ†’ General โ†’ Timezone
  • Should match your actual location
  • Solution: Set correct timezone

Check server time:

  • Go to WooCommerce โ†’ Status โ†’ System Status
  • Look for “Server Time”
  • Should match current time
  • Solution: Contact hosting if wrong

Issue: Export CSV is empty

Possible causes:

  1. No orders with delivery dates in selected range
  2. All orders filtered out by date range
  3. Orders placed before plugin was enabled won’t have dates

Solution:

  • Expand date range filter
  • Check that orders actually have delivery dates
  • Only orders placed AFTER plugin enabled will appear

Getting PHP Errors

↑ Back to top

If you see PHP errors or warnings:

What to collect:

  1. Full error message (copy entire text)
  2. Where error appeared (frontend? admin? checkout?)
  3. What you were doing when it occurred

Check PHP version:

  • Plugin requires PHP 8.1+
  • Go to WooCommerce โ†’ Status โ†’ System Status
  • Look for PHP version
  • If below 8.1, contact hosting to upgrade

Send to support:

  • Full error message
  • WordPress version
  • WooCommerce version
  • PHP version
  • Steps to reproduce

Frequently Asked Questions

↑ Back to top

General Questions

↑ Back to top

Q: Does this work with WooCommerce Block Checkout?

A: Yes! The plugin fully supports both Block Checkout (new) and Classic Checkout (old). All features work identically in both.

Q: Can I make the delivery date field optional instead of required?

A: No. The field is always required when the plugin is enabled. This is by design – the whole point is capturing delivery intent from every customer.

If you want optional behavior, disable the plugin for certain products/categories using the provided developer hooks.

Q: What if my customer doesn’t select a date?

A: They cannot complete checkout. The field is required. They’ll see an error message: “Delivery date is required” when they try to place order.

Q: Can customers change delivery date after ordering?

A: No. Customers cannot change it themselves. You (the store admin) can manually edit the delivery date from the order edit screen if needed.

Configuration Questions

↑ Back to top

Q: Why is handling time in HOURS not DAYS?

A: Hours provide more precision. Some businesses need 12-hour handling, others need 36 hours. Hours work for everyone.

To convert: 24 hours = 1 day, 48 hours = 2 days, etc.

Q: What’s the difference between handling time and minimum delivery days?

A: They’re cumulative:

  • Handling time = YOUR processing time
  • Min delivery = Customer’s minimum wait after processing

Example: 24h handling + 2 day minimum = 3 days total earliest delivery

Q: Can I set different settings for different products?

A: Not in the UI. Settings are global. For product-specific rules, use the developer hooks to customize validation logic.

Q: Why does the earliest date change based on cutoff time?

A: Orders after cutoff start processing the next business day, which pushes the earliest delivery date further out.

Dispatch Label Questions

↑ Back to top

Q: Can I customize the dispatch labels?

A: No. The three labels (Needs Review, Prepare Today, Dispatch Later) are automatic and cannot be customized. They’re calculated based on order analysis.

Q: Can I manually change an order’s dispatch label?

A: The labels are auto-calculated, but you CAN manually change the delivery date in the order, which will recalculate the label.

Q: What if an order is labeled “Needs Review” but I can actually fulfill it?

A: Great! The label is a warning, not a blocker. You can proceed with fulfillment. The label helps identify edge cases that need attention.

Q: Do dispatch labels integrate with shipping carriers?

A: No. Labels are for your internal planning only. They don’t sync with UPS, FedEx, or any carriers.

Dashboard Questions

↑ Back to top

Q: Why don’t I see all my orders?

A: The dashboard only shows orders where customers selected a delivery date. Orders from before plugin activation won’t appear.

Q: Can I filter by order status?

A: The date range filter is the main filter. For status filtering, use the main WooCommerce Orders page and filter there.

Q: Can I print labels from the dashboard?

A: No. The dashboard is for planning only. Use your shipping plugin (WooCommerce Shipping, ShipStation, etc.) for label printing.

Q: Does the dashboard work on mobile?

A: It’s functional but optimized for desktop. For mobile admin, use the WooCommerce app to view individual orders.

Compatibility & Integrations

↑ Back to top

Checkout Delivery Intent is explicitly compatible with:

  • WooCommerce Block Checkout and Classic Checkout
  • HPOS (High-Performance Order Storage)
  • WooCommerce Subscriptions
  • Most shipping and payment extensions
  • WPML and Polylang

It does not integrate with shipping carriers or third-party APIs by design.

Technical Questions

↑ Back to top

Q: Is this compatible with [plugin name]?

A: Compatible with most plugins. Known compatible:

  • WooCommerce Subscriptions
  • WPML / Polylang
  • Most shipping plugins
  • Most payment gateways
  • HPOS (High-Performance Order Storage)

If you find a conflict, report it to support.

Q: Does this slow down checkout?

A: No. Validation only runs when checkout form is submitted. No performance impact on page load or browsing.

Q: Where is data stored?

A: In your WooCommerce database:

  • _delivery_date meta field on orders
  • _delivery_time meta field (if time enabled)
  • _dispatch_label meta field

All visible in order edit screen โ†’ Custom Fields section.

Q: Can I export order data via API?

A: Yes. Use WooCommerce REST API. Delivery data is in order meta:

GET /wp-json/wc/v3/orders/{id}
Response includes meta_data array with delivery_date

Q: Does this send any data externally?

A: No. Everything stays in your WordPress database. No external APIs, no tracking, no data sent anywhere.

Time Selection Questions

↑ Back to top

Q: If I enable time selection, is it required?

A: No. Date is always required, but time is optional even when enabled.

Q: Can I offer different time slots on different days?

A: Not in the UI. The same time slots appear for all days. For custom logic, use developer hooks.

Q: What time slots are generated?

A: Depends on your interval:

  • 30 min: 9:00-9:30, 9:30-10:00, etc. (8 AM – 8 PM)
  • 60 min: 9:00-10:00, 10:00-11:00, etc.
  • 120 min: 9:00-11:00, 11:00-1:00, etc.

Time range: 8:00 AM to 8:00 PM by default.


Getting Help

↑ Back to top

Before Contacting Support

↑ Back to top

1. Check this documentation – Most questions answered above

2. Check WooCommerce System Status

  • Go to WooCommerce โ†’ Status โ†’ System Status
  • Look for errors or warnings
  • Note your versions

3. Try basic troubleshooting:

  • Clear cache
  • Disable other plugins temporarily
  • Switch to default theme temporarily
  • Check in incognito/private browser

How to Contact Support

↑ Back to top

Email Support:

  • support@zologic.nl
  • Response time: Within 24-48 hours on business days

Include in your message:

WordPress Version: 6.9
WooCommerce Version: 10.4.3
Plugin Version: 1.0.5
PHP Version: 8.1.2
Theme: Storefront 4.5

Issue Description:
[Describe what's happening]

Steps to Reproduce:
1. [What you did]
2. [What happened]
3. [What you expected]

Screenshots:
[Attach if relevant]

For faster support:

  • Be specific about the issue
  • Include error messages (exact text)
  • Mention what you’ve already tried
  • Attach screenshots if helpful

System Information to Collect

↑ Back to top

From WooCommerce โ†’ Status โ†’ System Status:

  • WordPress version
  • WooCommerce version
  • PHP version
  • Active plugins list
  • Theme name and version

From browser console (F12):

  • Any JavaScript errors (red text)
  • Screenshot of console if errors present

What Support Covers

↑ Back to top
  • We help with:
  • Installation and activation
  • Configuration guidance
  • Troubleshooting errors
  • Compatibility issues
  • Bug fixes
  • Feature explanations
  • We don’t provide:
  • Custom development (contact for quote)
  • Theme modifications
  • Server configuration
  • Third-party plugin support

Feature Requests

↑ Back to top

We welcome suggestions!

To submit a feature request:

  1. Email support with subject: “Feature Request”
  2. Describe the feature
  3. Explain your use case
  4. We’ll review for future versions

Current roadmap considerations:

  • Delivery date range selection (e.g., “Feb 5-7”)
  • Carrier-specific settings
  • Per-product delivery windows
  • Customer delivery date change requests

Updates and Changelog

↑ Back to top

Stay Informed:

  • Updates released regularly
  • Check changelog before updating
  • Test on staging site when possible
  • All updates are backward-compatible within the 1.0.x series and do not alter existing order data
    To update:
  1. Backup your site
  2. Go to Plugins โ†’ Update
  3. Click “Update Now” for this plugin
  4. Test checkout and dashboard after update

Current version: 1.0.5 (as of Jan 2026)


Additional Resources

↑ Back to top

WooCommerce Resources

↑ Back to top

Developer Documentation

↑ Back to top

For developers who want to extend the plugin, see the included developer documentation:

  • Available hooks and filters
  • Meta key reference
  • REST API integration
  • Custom validation examples

Video Tutorials

↑ Back to top

(To be added – check website for updates)


Document Information

↑ Back to top

Last Updated: February 3, 2026
Plugin Version: 1.0.5
Applies To: All versions 1.0.x

Changelog:

  • v1.0 – Initial documentation
  • v1.1 – Added time selection section
  • v1.2 – Corrected system requirements
  • v1.3 – Enhanced dispatch label explanation

Thank you for choosing Checkout Delivery Intent!

We’re committed to helping you capture realistic delivery expectations and plan your fulfillment more effectively.

For additional assistance, contact our support team at support@zologic.nl
We aim to respond within 24โ€“48 business hours.

Related Products

Offer add-ons like gift wrapping, special messages or other special options for your products.

Add shipment tracking information to your orders.