Delivery Time Estimator
Plan your shipments and set accurate delivery expectations with this transit time calculator. Estimate delivery windows for various shipping methods from ground to overnight. Factor in origin and destination zones, carrier processing times, and potential delays. Perfect for e-commerce businesses setting shipping expectations, logistics planners, and anyone needing to coordinate deliveries.
Try the Calculator
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
export function deliveryTimeCalculator(form: FormTs) {
form.addRow(row => {
row.addTextPanel('header', {
computedValue: () => 'Delivery Time Estimator',
customStyles: { 'font-size': '1.5rem', 'font-weight': '600', 'color': '#1e293b' }
});
});
form.addSpacer({ height: 20 });
// Ship Date Section
const dateSection = form.addSubform('date', { title: '📅 Ship Date' });
dateSection.addRow(row => {
row.addDropdown('shipDay', {
label: 'Ship Day',
options: [
{ id: 'monday', name: 'Monday' },
{ id: 'tuesday', name: 'Tuesday' },
{ id: 'wednesday', name: 'Wednesday' },
{ id: 'thursday', name: 'Thursday' },
{ id: 'friday', name: 'Friday' },
{ id: 'saturday', name: 'Saturday' },
{ id: 'sunday', name: 'Sunday' }
],
defaultValue: 'monday',
isRequired: true
}, '1fr');
row.addDropdown('cutoffTime', {
label: 'Carrier Pickup Cutoff',
options: [
{ id: 'before-noon', name: 'Before 12:00 PM' },
{ id: 'before-3pm', name: 'Before 3:00 PM' },
{ id: 'before-5pm', name: 'Before 5:00 PM' },
{ id: 'after-cutoff', name: 'After Daily Cutoff' }
],
defaultValue: 'before-3pm',
tooltip: 'When package reaches carrier'
}, '1fr');
});
dateSection.addRow(row => {
row.addInteger('processingDays', {
label: 'Processing Time (business days)',
min: 0,
max: 10,
defaultValue: 1,
tooltip: 'Time to prepare and ship order'
});
});
// Route Section
const routeSection = form.addSubform('route', { title: '📍 Origin & Destination' });
routeSection.addRow(row => {
row.addAddress('originAddress', {
label: 'Ship From',
placeholder: 'Enter origin address...',
restrictToCountries: ['US'],
distanceUnit: 'miles',
isRequired: true
});
});
routeSection.addRow(row => {
row.addAddress('destAddress', {
label: 'Ship To',
placeholder: 'Enter destination address...',
showMap: true,
showDistance: true,
referenceAddress: () => routeSection.address('originAddress')?.value() ?? null,
restrictToCountries: ['US'],
distanceUnit: 'miles',
isRequired: true
});
});
// Helper to get zone from distance
const getZoneFromDistance = () => {
const destField = routeSection.address('destAddress');
const miles = destField?.distance();
if (miles == null) return 'zone4'; // default
if (miles < 50) return 'zone1';
if (miles < 150) return 'zone2';
if (miles < 300) return 'zone3';
if (miles < 600) return 'zone4';
if (miles < 1000) return 'zone5';
if (miles < 1400) return 'zone6';
if (miles < 1800) return 'zone7';
return 'zone8';
};
routeSection.addRow(row => {
row.addTextPanel('zoneInfo', {
computedValue: () => {
const destField = routeSection.address('destAddress');
const miles = destField?.distance();
if (miles == null) return 'Enter both addresses to see shipping zone';
const zone = getZoneFromDistance();
const zoneLabels: Record<string, string> = {
'zone1': 'Zone 1 - Local',
'zone2': 'Zone 2 - Regional',
'zone3': 'Zone 3 - Short distance',
'zone4': 'Zone 4 - Medium distance',
'zone5': 'Zone 5 - Long distance',
'zone6': 'Zone 6 - Very long distance',
'zone7': 'Zone 7 - Extended distance',
'zone8': 'Zone 8 - Cross-country'
};
return `📍 ${zoneLabels[zone]} (${Math.round(miles)} miles)`;
},
customStyles: { 'font-size': '0.9rem', 'color': '#0369a1', 'background': '#e0f2fe', 'padding': '10px', 'border-radius': '6px' }
});
});
routeSection.addRow(row => {
row.addDropdown('destType', {
label: 'Destination Type',
options: [
{ id: 'commercial', name: 'Commercial Address' },
{ id: 'residential', name: 'Residential Address' },
{ id: 'pobox', name: 'PO Box' },
{ id: 'rural', name: 'Rural / Remote' }
],
defaultValue: 'residential'
}, '1fr');
});
// Shipping Method Section
const methodSection = form.addSubform('method', { title: '🚚 Shipping Method' });
methodSection.addRow(row => {
row.addDropdown('carrier', {
label: 'Carrier',
options: [
{ id: 'usps', name: 'USPS' },
{ id: 'ups', name: 'UPS' },
{ id: 'fedex', name: 'FedEx' },
{ id: 'dhl', name: 'DHL' },
{ id: 'regional', name: 'Regional Carrier' }
],
defaultValue: 'ups',
isRequired: true
}, '1fr');
row.addDropdown('service', {
label: 'Service Level',
options: [
{ id: 'ground', name: 'Ground / Standard' },
{ id: 'express', name: '3-Day / Express' },
{ id: 'priority', name: '2-Day / Priority' },
{ id: 'overnight', name: 'Overnight / Next Day' },
{ id: 'sameday', name: 'Same Day' }
],
defaultValue: 'ground',
isRequired: true
}, '1fr');
});
methodSection.addRow(row => {
row.addCheckbox('saturdayDelivery', {
label: 'Saturday Delivery',
defaultValue: false,
tooltip: 'Additional fee applies'
}, '1fr');
row.addCheckbox('signatureRequired', {
label: 'Signature Required',
defaultValue: false,
tooltip: 'May affect delivery timing'
}, '1fr');
});
// Factors Section
const factorsSection = form.addSubform('factors', { title: '⚠️ Potential Delay Factors' });
factorsSection.addRow(row => {
row.addCheckbox('peakSeason', {
label: 'Peak Season (Nov-Dec)',
defaultValue: false,
tooltip: 'Holiday shipping delays'
}, '1fr');
row.addCheckbox('weather', {
label: 'Weather Advisory',
defaultValue: false,
tooltip: 'Severe weather in route'
}, '1fr');
});
factorsSection.addRow(row => {
row.addCheckbox('oversized', {
label: 'Oversized Package',
defaultValue: false,
tooltip: 'May require special handling'
}, '1fr');
row.addCheckbox('international', {
label: 'International Destination',
defaultValue: false,
tooltip: 'Customs clearance required'
}, '1fr');
});
form.addSpacer({ height: 20, showLine: true, lineStyle: 'dashed' });
// Delivery Estimate Section
const estimateSection = form.addSubform('estimate', { title: '📦 Delivery Estimate', isCollapsible: false });
estimateSection.addRow(row => {
row.addTextPanel('transitDays', {
computedValue: () => {
const zone = getZoneFromDistance();
const service = methodSection.dropdown('service')?.value() || 'ground';
const destType = routeSection.dropdown('destType')?.value() || 'residential';
const peakSeason = factorsSection.checkbox('peakSeason')?.value();
const weather = factorsSection.checkbox('weather')?.value();
const oversized = factorsSection.checkbox('oversized')?.value();
const international = factorsSection.checkbox('international')?.value();
// Base transit days by service
const baseTransit: Record<string, Record<string, number>> = {
'sameday': { 'zone1': 0, 'zone2': 0, 'zone3': 0, 'zone4': 0, 'zone5': 0, 'zone6': 0, 'zone7': 0, 'zone8': 0 },
'overnight': { 'zone1': 1, 'zone2': 1, 'zone3': 1, 'zone4': 1, 'zone5': 1, 'zone6': 1, 'zone7': 1, 'zone8': 1 },
'priority': { 'zone1': 2, 'zone2': 2, 'zone3': 2, 'zone4': 2, 'zone5': 2, 'zone6': 2, 'zone7': 2, 'zone8': 2 },
'express': { 'zone1': 2, 'zone2': 2, 'zone3': 3, 'zone4': 3, 'zone5': 3, 'zone6': 3, 'zone7': 3, 'zone8': 3 },
'ground': { 'zone1': 1, 'zone2': 2, 'zone3': 3, 'zone4': 4, 'zone5': 5, 'zone6': 5, 'zone7': 6, 'zone8': 7 }
};
let days = baseTransit[service]?.[zone] || 5;
// Adjustments
if (destType === 'rural') days += 1;
if (destType === 'pobox' && service !== 'ground') days += 1;
if (peakSeason) days += 2;
if (weather) days += 1;
if (oversized) days += 1;
if (international) days += 5;
return `Transit Time: ${days} business day${days !== 1 ? 's' : ''}`;
},
customStyles: { 'font-size': '1.2rem', 'font-weight': '600', 'color': '#0284c7', 'text-align': 'center' }
});
});
estimateSection.addRow(row => {
row.addTextPanel('deliveryWindow', {
computedValue: () => {
const zone = getZoneFromDistance();
const service = methodSection.dropdown('service')?.value() || 'ground';
const destType = routeSection.dropdown('destType')?.value() || 'residential';
const peakSeason = factorsSection.checkbox('peakSeason')?.value();
const weather = factorsSection.checkbox('weather')?.value();
const oversized = factorsSection.checkbox('oversized')?.value();
const international = factorsSection.checkbox('international')?.value();
const processingDays = dateSection.integer('processingDays')?.value() || 1;
const cutoff = dateSection.dropdown('cutoffTime')?.value() || 'before-3pm';
const baseTransit: Record<string, Record<string, number>> = {
'sameday': { 'zone1': 0, 'zone2': 0, 'zone3': 0, 'zone4': 0, 'zone5': 0, 'zone6': 0, 'zone7': 0, 'zone8': 0 },
'overnight': { 'zone1': 1, 'zone2': 1, 'zone3': 1, 'zone4': 1, 'zone5': 1, 'zone6': 1, 'zone7': 1, 'zone8': 1 },
'priority': { 'zone1': 2, 'zone2': 2, 'zone3': 2, 'zone4': 2, 'zone5': 2, 'zone6': 2, 'zone7': 2, 'zone8': 2 },
'express': { 'zone1': 2, 'zone2': 2, 'zone3': 3, 'zone4': 3, 'zone5': 3, 'zone6': 3, 'zone7': 3, 'zone8': 3 },
'ground': { 'zone1': 1, 'zone2': 2, 'zone3': 3, 'zone4': 4, 'zone5': 5, 'zone6': 5, 'zone7': 6, 'zone8': 7 }
};
let days = baseTransit[service]?.[zone] || 5;
if (destType === 'rural') days += 1;
if (destType === 'pobox' && service !== 'ground') days += 1;
if (peakSeason) days += 2;
if (weather) days += 1;
if (oversized) days += 1;
if (international) days += 5;
// Add processing days and cutoff adjustment
let totalDays = processingDays + days;
if (cutoff === 'after-cutoff') totalDays += 1;
const minDays = totalDays;
const maxDays = totalDays + (peakSeason || weather ? 2 : 1);
return `Estimated Delivery: ${minDays}-${maxDays} business days from order`;
},
customStyles: { 'font-size': '1rem', 'font-weight': '500', 'color': '#059669', 'text-align': 'center' }
});
});
estimateSection.addRow(row => {
row.addTextPanel('deliveryTime', {
computedValue: () => {
const service = methodSection.dropdown('service')?.value() || 'ground';
const destType = routeSection.dropdown('destType')?.value() || 'residential';
if (service === 'sameday') return 'Delivery by end of day';
if (service === 'overnight') return 'Delivery by 10:30 AM (commercial) or 3:00 PM (residential)';
if (service === 'priority') return 'Delivery by end of day (typically by 5:00 PM)';
if (destType === 'commercial') {
return 'Delivery typically by 5:00 PM';
} else {
return 'Delivery typically between 9:00 AM - 7:00 PM';
}
},
customStyles: { 'font-size': '0.9rem', 'color': '#64748b', 'text-align': 'center' }
});
});
// Timeline Section
const timelineSection = form.addSubform('timeline', { title: '📋 Shipment Timeline', isCollapsible: true });
timelineSection.addRow(row => {
row.addTextPanel('step1', {
computedValue: () => {
const processingDays = dateSection.integer('processingDays')?.value() || 1;
return `1. Order Processing: ${processingDays} business day${processingDays !== 1 ? 's' : ''}`;
},
customStyles: { 'font-size': '0.9rem', 'color': '#1e293b' }
});
});
timelineSection.addRow(row => {
row.addTextPanel('step2', {
computedValue: () => {
const cutoff = dateSection.dropdown('cutoffTime')?.value() || 'before-3pm';
const cutoffLabels: Record<string, string> = {
'before-noon': '12:00 PM', 'before-3pm': '3:00 PM',
'before-5pm': '5:00 PM', 'after-cutoff': 'next business day'
};
return `2. Carrier Pickup: By ${cutoffLabels[cutoff]}`;
},
customStyles: { 'font-size': '0.9rem', 'color': '#1e293b' }
});
});
timelineSection.addRow(row => {
row.addTextPanel('step3', {
computedValue: () => {
const zone = getZoneFromDistance();
const service = methodSection.dropdown('service')?.value() || 'ground';
const baseTransit: Record<string, Record<string, number>> = {
'sameday': { 'zone1': 0, 'zone2': 0, 'zone3': 0, 'zone4': 0, 'zone5': 0, 'zone6': 0, 'zone7': 0, 'zone8': 0 },
'overnight': { 'zone1': 1, 'zone2': 1, 'zone3': 1, 'zone4': 1, 'zone5': 1, 'zone6': 1, 'zone7': 1, 'zone8': 1 },
'priority': { 'zone1': 2, 'zone2': 2, 'zone3': 2, 'zone4': 2, 'zone5': 2, 'zone6': 2, 'zone7': 2, 'zone8': 2 },
'express': { 'zone1': 2, 'zone2': 2, 'zone3': 3, 'zone4': 3, 'zone5': 3, 'zone6': 3, 'zone7': 3, 'zone8': 3 },
'ground': { 'zone1': 1, 'zone2': 2, 'zone3': 3, 'zone4': 4, 'zone5': 5, 'zone6': 5, 'zone7': 6, 'zone8': 7 }
};
const days = baseTransit[service]?.[zone] || 5;
return `3. In Transit: ${days} business day${days !== 1 ? 's' : ''}`;
},
customStyles: { 'font-size': '0.9rem', 'color': '#1e293b' }
});
});
timelineSection.addRow(row => {
row.addTextPanel('step4', {
computedValue: () => '4. Out for Delivery: Day of delivery',
customStyles: { 'font-size': '0.9rem', 'color': '#1e293b' }
});
});
// Summary Section
const summarySection = form.addSubform('summary', {
title: '📋 Summary',
isCollapsible: false,
sticky: 'bottom'
});
summarySection.addRow(row => {
row.addTextPanel('summaryText', {
computedValue: () => {
const carrier = methodSection.dropdown('carrier')?.value() || 'ups';
const service = methodSection.dropdown('service')?.value() || 'ground';
const destField = routeSection.address('destAddress');
const miles = destField?.distance();
const originAddr = routeSection.address('originAddress')?.value();
const destAddr = routeSection.address('destAddress')?.value();
const originCity = originAddr?.formattedAddress?.split(',')[0] || 'Origin';
const destCity = destAddr?.formattedAddress?.split(',')[0] || 'Destination';
const carrierLabels: Record<string, string> = {
'usps': 'USPS', 'ups': 'UPS', 'fedex': 'FedEx', 'dhl': 'DHL', 'regional': 'Regional'
};
const serviceLabels: Record<string, string> = {
'ground': 'Ground', 'express': '3-Day', 'priority': '2-Day', 'overnight': 'Overnight', 'sameday': 'Same Day'
};
const distanceText = miles != null ? ` (${Math.round(miles)} mi)` : '';
return `${carrierLabels[carrier]} ${serviceLabels[service]} | ${originCity} → ${destCity}${distanceText}`;
},
customStyles: { 'font-size': '0.95rem', 'font-weight': '500', 'text-align': 'center', 'color': '#1e293b' }
});
});
summarySection.addRow(row => {
row.addTextPanel('disclaimer', {
computedValue: () => 'Estimates based on standard carrier service. Actual delivery may vary due to carrier delays, weather, or customs.',
customStyles: { 'font-size': '0.8rem', 'color': '#64748b', 'text-align': 'center' }
});
});
form.configureSubmitButton({
label: 'Track Shipment'
});
}
Frequently Asked Questions
How accurate are delivery estimates?
Estimates are based on carrier service standards and typically accurate within 1-2 days. Weather, holidays, peak seasons, and carrier delays can affect actual delivery times.
What's the difference between shipping methods?
Ground typically takes 3-7 days depending on distance. Express/Priority is 2-3 days. Overnight guarantees next-day delivery. Same-day is available in select metro areas.
Do weekends count as transit days?
Most standard shipping services don't deliver on weekends. Saturday delivery is available as a premium add-on with some carriers. Sunday delivery is limited.
What causes delivery delays?
Common causes include weather events, high shipping volumes (holidays), customs delays (international), incorrect addresses, and carrier sorting errors.