📅 DeliverDate Pro User Guide

📊 Admin Panel Overview

The DeliverDate Pro admin panel is your control center for delivery date configuration. Access it anytime by:

1. Going to Apps & Features → My Apps in BigCommerce
2. Finding DeliverDate Pro
3. Clicking Launch

Main Sections

⚙️ Basic Settings

Configure the core parameters for your delivery date system.

Store Timezone

Select your store's timezone from the dropdown. This is critical for accurate date calculations.

• Why it matters: Dates are compared in your local timezone, not UTC
• Example: If you're in Eastern Time and set a holiday for Dec 25, customers on the West Coast will see the same date disabled
• Options: All major US and international timezones are available

Minimum Delivery Days

How many days in the future can customers select a delivery date?

• Default: 0 (customers can select today)
• Example: Set to 3 to require orders 3+ days in advance
• Use case: Processing time before delivery (e.g., custom orders need 2-3 days)

Maximum Delivery Days

What's the latest date customers can schedule delivery?

• Default: 365 days (one year)
• Example: Set to 30 to limit to 30 days out
• Use case: Limit advance orders for perishables or seasonal items

🕒 Business Hours

Tell customers which days you're open for delivery orders.

How It Works

1. Check the box next to each day you operate
2. Unchecked days appear grayed out in the date picker
3. Customers cannot select delivery on days you're closed

Day Labels

Customize the label for each day of the week. By default, Sunday is labeled "Pickup Only".

• Click any day's label to edit it
• Examples: "Delivery Only", "Closed", "Curbside Pickup", etc.
• These labels appear in the date picker as tooltips

Example Configurations

Monday-Friday Delivery: Check Mon-Fri, uncheck Sat-Sun

6-Day Operation: Check Mon-Sat, uncheck Sun only

24/7 Operation: Check all days

🎉 Holidays & Blackout Dates

Block specific dates when your store is closed or unavailable for delivery.

Holidays (Annual)

Holidays repeat every year automatically.

1. Click "Add Holiday"
2. Enter the date in MM-DD format (e.g., 12-25 for Christmas)
3. Enter a tooltip (e.g., "Christmas - Closed")
4. Click "Save Config"

Common Holidays Examples

• 01-01 – New Year's Day
• 07-04 – Independence Day
• 11-23 – Thanksgiving (fourth Thursday - calculate your date)
• 12-25 – Christmas

Blackout Dates (One-Off)

Block specific dates when you won't be available (vacation, inventory, etc.).

1. Click "Add Blackout Date"
2. Enter the date in YYYY-MM-DD format (e.g., 2026-03-15)
3. Click "Save Config"

Blackout Date Use Cases

• Staff vacation week (e.g., 2026-08-10 to 2026-08-17)
• Warehouse maintenance (e.g., 2026-02-14)
• Supply chain disruption
• Special event (e.g., store relocation)

Holiday Tooltips

Customize the message that appears when customers hover over a holiday date.

• Add context: "Closed for Thanksgiving" instead of just "Holiday"
• Set customer expectations: "Limited delivery - 2-3 day delay"
• Be friendly: "Happy New Year! Reopening 01-02"

🔄 Recurring Closures

Block entire days of the week from customer selection (independent of Business Hours).

How It Differs from Business Hours

• Business Hours: Which days you're open (Mon-Fri, etc.)
• Recurring Closures: Which days customers can't select (complementary setting)

When to Use

Example: You're open Monday-Saturday, but your logistics only handles weekday deliveries. Set Sunday and Saturday as recurring closures.

1. Check "Disable Sunday" and "Disable Saturday"
2. Even though your store is open, customers can't select those days
3. Useful for separating "open" from "delivery available"

✏️ Customization

Personalize the date picker to match your brand.

Custom Button Text

Replace "Select Delivery Date" with your own label.

• Default: "Select Delivery Date"
• Custom: "Pick your delivery date" or "When do you want it?"
• With date: "Deliver by [selected date]"

Using Date Templates

Include {date} in your button text to show the selected date.

• "Deliver by {date}" → Shows "Deliver by Dec 25, 2026"
• "Pickup on {date}" → Shows "Pickup on Dec 25, 2026"
• "{date}" → Shows just the date
• Without {date} → Text prepends the date (e.g., "Choose date: Dec 25, 2026")

Holiday Tooltip Text

Customize what appears when customers hover over a holiday or blackout date.

• Default: Holiday name (e.g., "Christmas")
• Custom: "Closed for Christmas - Orders resume 12/26"
• Add context to manage expectations

💡 Best Practices

1. Set Your Timezone First

This is the most critical setting. Double-check it's correct before configuring holidays/blackouts.

2. Plan Your Minimum Delivery Days

Consider:

• Order processing time (1-2 days)
• Shipping/delivery time (1-3 days)
• Total minimum = processing + shipping

3. Be Clear with Customers

Use custom button text and holiday tooltips to set expectations:

• "Deliver by {date}" makes the intent clear
• "Closed Dec 24-26" explains why dates are blocked

4. Update Blackout Dates Early

Add vacation and maintenance windows 1-2 months in advance so customers can plan.

5. Test the Picker

After saving config:

• Visit your store and add a product to cart
• Verify dates are disabled correctly
• Check hover tooltips appear
• Select a date and verify it saves

6. Document Changes

The app tracks save history automatically, but document major changes in your business notes for future reference.

❓ Frequently Asked Questions

Q: Does the date picker work on Catalyst storefronts?

A: Yes! DeliverDate Pro fully supports both Stencil and Catalyst storefronts. The app automatically detects your theme type and adapts. Catalyst storefronts show day-of-week labels (e.g., "Sun, Dec 25") in the date display.

Q: Does it work with Multi-Storefront setups?

A: Absolutely! When you save your configuration, the app automatically injects the script across all your storefronts (requires the store_channel_settings_read_only OAuth scope, which is granted during installation).

Q: Why does the date picker disappear after I change config?

A: Clear your browser cache (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac) and refresh. The app updates in real-time.

Q: Can I set multiple blackout dates at once?

A: Currently you add them one at a time, but you can add them quickly. We recommend batching them when planning vacation.

Q: What if I forget to add a holiday?

A: No problem! Add it anytime. Customers who already ordered won't be affected. Future orders will see the updated dates.

Q: Does the date picker work on mobile?

A: Yes! The picker is fully responsive and works on all devices. Tap the button to open the calendar.

Q: Can customers still place orders on disabled dates?

A: No. Disabled dates are grayed out and unselectable in the picker. Orders can't proceed without a valid date.

Q: What happens to orders during daylight saving time?

A: Our system uses your selected timezone and handles DST automatically. No action needed from you.

Q: Can I set different delivery dates for different products?

A: Currently, all products use the same delivery date rules. If you need product-specific dates, contact us about custom solutions.

Q: How often should I review my configuration?

A: Review quarterly or when:

• Your business hours change (seasonal shifts)
• You plan vacations or maintenance
• You add new holidays or blackout dates

Q: What if my store operates 24/7?

A: Check all days under Business Hours and set Minimum Delivery Days to 0. Customers can order anytime.

🆘 Still having issues?

Contact our support team at support@shareflowx.com with your store URL, screenshots, and details about what you've tried.