What Is businessDays in Shipping Schema?
businessDays identifies the days of the week when a merchant typically operates for a shipping timing period.
The property can use DayOfWeek or OpeningHoursSpecification and appears on ServicePeriod and ShippingDeliveryTime. It helps determine which days count while handling or transit duration advances.
businessDays does not by itself prove holiday openings, temporary closures, warehouse capacity, or carrier service. Those operational exceptions still need an authoritative source and must be reflected in the final checkout promise.
- Identify the exact page, asset, entity or relationship described in this section.
- Inspect the live implementation and retain the observed evidence.
- Compare the observation with the intended meaning and its primary specification.
- Correct any mismatch, then retest the live result.
- Record the accountable owner and review date.
| Case | Meaning | Action |
|---|---|---|
| businessDays | Operating weekdays | Define counted days |
| DayOfWeek | Simple weekday value | Use for regular schedule |
| OpeningHoursSpecification | Structured hours markup | Use when hours matter |
| ServicePeriod | Constrained duration | Common context |
| Delivery date | Composite outcome | Apply full policy |
- Identify the operating authority.
- Choose a supported value type.
- Connect the calendar to its timing period.
- Test final dates.
Use the free backlink checker to identify linked pages before changing a shared shipping calendar.
Primary specification: Schema.org definition for businessDays.
businessDays is accurate when only the merchant's real operating days advance the relevant preparation or delivery period.
Where Can businessDays Be Used?
businessDays can be used on ServicePeriod and ShippingDeliveryTime, with DayOfWeek or OpeningHoursSpecification values.
A ServicePeriod can combine businessDays with duration and cutoffTime for handling or transit timing. ShippingDeliveryTime can also carry the property in a total-delivery structure.
Do not attach businessDays directly to Product, Offer, ShippingService, ShippingConditions, ShippingRateSettings, or Organization. Those entities may contain or connect to the timing structure, but they are not listed parents for this property.
- The exact page, asset, entity or relationship covered by this section
- The live implementation rather than an editor-only preview
- The primary specification or first-party record defining the expected behavior
- The validation result, accountable owner and review date
| Case | Meaning | Action |
|---|---|---|
| ServicePeriod | Supported parent | Calendar for constrained period |
| ShippingDeliveryTime | Supported parent | Total timing calendar |
| DayOfWeek | Expected value | Simple schedule |
| OpeningHoursSpecification | Expected value | Detailed operating schedule |
| ShippingService | Indirect context | Use handling ServicePeriod |
- Identify the timing parent.
- Use supported calendar values.
- Keep service and condition relationships intact.
- Validate the rendered graph.
Review ServicePeriod and ShippingService.
Correct placement attaches the calendar to the exact period whose duration it controls.
Should You Use DayOfWeek or OpeningHoursSpecification?
Use DayOfWeek for a straightforward operating-day list and OpeningHoursSpecification when the source needs structured opening hours for those days.
A warehouse that processes orders Monday through Friday with one daily schedule may use weekday values. A pickup store whose preparation window depends on opening and closing hours may need OpeningHoursSpecification to preserve more context.
Choose the smallest model that reproduces the real policy. Extra hours are harmful when guessed, while a weekday-only list is incomplete when time-of-day availability changes whether an order can be prepared.
- Identify the exact page, asset, entity or relationship described in this section.
- Inspect the live implementation and retain the observed evidence.
- Compare the observation with the intended meaning and its primary specification.
- Correct any mismatch, then retest the live result.
- Record the accountable owner and review date.
| Case | Meaning | Action |
|---|---|---|
| Monday–Friday only | DayOfWeek | Simple regular schedule |
| Store hours vary | OpeningHoursSpecification | Structured hours |
| Hours unavailable | Do not invent | Use verified weekday facts |
| Cutoff differs by day | Detailed schedule needed | Model source context |
| Same hours every day | Either supported shape | Prefer simplest true model |
- Inspect the operational source.
- Decide whether hours affect behavior.
- Choose the minimal complete type.
- Test representative orders.
The right businessDays value type is the simplest one that preserves every operational distinction affecting the timing promise.
How Do businessDays Affect handlingTime?
For handlingTime, businessDays determines which merchant operating days count from order receipt until dispatch or pickup readiness.
An order received Friday after cutoff may not begin handling until Monday for a Monday-through-Friday warehouse. A store open Saturday may prepare pickup sooner. The result depends on the service, origin, cutoff, and local calendar together.
Apply cutoff classification before advancing the handling duration, then count only valid operating days. Do not count carrier transit at the handling stage or apply the same calendar twice.
- The exact page, asset, entity or relationship covered by this section
- The live implementation rather than an editor-only preview
- The primary specification or first-party record defining the expected behavior
- The validation result, accountable owner and review date
| Case | Meaning | Action |
|---|---|---|
| Friday before cutoff | Current-day handling candidate | Apply duration |
| Friday after cutoff | Next operating start | Advance calendar |
| Saturday warehouse open | Saturday may count | Use actual schedule |
| Pickup store closed | No readiness work | Skip day |
| Double calendar application | Extra delay | Centralize calculation |
- Resolve order timestamp and cutoff.
- Select the origin calendar.
- Advance handling duration.
- Produce dispatch or pickup-ready time.
See handlingTime in ShippingService.
businessDays supports handling correctly when its counted days produce the same readiness timestamp as fulfillment operations.
How Do businessDays Affect transitTime?
For transitTime, businessDays determines which service operating days count after dispatch until the goods reach the customer.
Carrier calendars can differ from warehouse calendars. A warehouse may operate Saturday while the selected carrier service does not, or a scheduled delivery service may have destination-specific delivery days.
Keep handling and transit ServicePeriod calendars separate whenever their authorities differ. Start transit only after dispatch and apply the calendar of the chosen route and service.
- Identify the exact page, asset, entity or relationship described in this section.
- Inspect the live implementation and retain the observed evidence.
- Compare the observation with the intended meaning and its primary specification.
- Correct any mismatch, then retest the live result.
- Record the accountable owner and review date.
| Case | Meaning | Action |
|---|---|---|
| Warehouse open Saturday | Handling may advance | Not carrier proof |
| Carrier closed Sunday | Transit does not advance | Use service calendar |
| Express weekend delivery | Special service | Separate condition |
| Remote region | Different route schedule | Scope destination |
| Pickup | No default carrier transit | Stop at readiness |
- Calculate dispatch first.
- Select carrier and service calendar.
- Apply route and destination rules.
- Calculate arrival window.
Compare transitTime in ShippingConditions.
Transit business days are accurate when they follow the selected carrier service rather than inheriting a merchant warehouse calendar.
How Should Holidays and Temporary Closures Be Handled?
Holidays and temporary closures should come from the authoritative operational calendar and adjust calculated dates even when the regular businessDays pattern remains unchanged.
A Monday-through-Friday schedule describes typical weekdays, not every exception. Federal holidays, local holidays, inventory counts, severe-weather closures, peak-season extensions, and carrier embargoes can change processing or transit.
Do not claim that a regular weekday list encodes all holidays. Maintain exception dates in the fulfillment system, regenerate customer promises, and test closures separately from the structured regular schedule supported by the target consumer.
- The exact page, asset, entity or relationship covered by this section
- The live implementation rather than an editor-only preview
- The primary specification or first-party record defining the expected behavior
- The validation result, accountable owner and review date
| Case | Meaning | Action |
|---|---|---|
| Regular weekday | Typical operation | businessDays covers pattern |
| Federal holiday | Closure exception | Skip when source says closed |
| Peak Saturday opening | Temporary extension | Use effective policy |
| Weather closure | Unplanned exception | Update promise source |
| Carrier embargo | Transit exception | Adjust route calendar |
- Maintain regular schedules.
- Maintain dated exceptions.
- Apply both in calculations.
- Update promises and caches.
- Retest affected cohorts.
Holiday handling is honest when regular markup and operational exceptions combine into the same date shown at checkout.
How Do Multiple Warehouses, Stores, and Sellers Use businessDays?
Each warehouse, pickup store, marketplace seller, and carrier service may require a separate businessDays calendar because operating days and hours differ.
A universal merchant calendar can make a West Coast warehouse, franchised store, or seller appear to process orders when it is closed. Multi-origin carts may produce separate readiness and arrival windows.
Resolve seller, inventory location, origin, service, and pickup location before selecting the calendar. Preserve stable entity identities so a crawler can connect the right ServicePeriod to the right fulfillment source.
- The exact page, asset, entity or relationship covered by this section
- The live implementation rather than an editor-only preview
- The primary specification or first-party record defining the expected behavior
- The validation result, accountable owner and review date
| Case | Meaning | Action |
|---|---|---|
| Warehouse A | Monday–Friday | Calendar A |
| Warehouse B | Tuesday–Saturday | Calendar B |
| Pickup store | Local opening hours | Store calendar |
| Marketplace seller | Seller schedule | Seller authority |
| Split shipment | Multiple calendars | Calculate per package |
- Resolve seller and stock.
- Resolve origin or pickup location.
- Select its calendar.
- Calculate each shipment.
- Combine per checkout policy.
Multi-source calendars are correct when each package or pickup uses the schedule of the entity that actually fulfills it.
What businessDays Mistakes Are Common?
Common businessDays mistakes include using the wrong parent or value type, assuming Monday through Friday for every service, sharing one calendar across origins, mixing warehouse and carrier days, ignoring cutoff order, and treating regular weekdays as complete holiday coverage.
Other defects include duplicate or empty weekday lists, invalid opening-hour relationships, stale pickup schedules, mismatched time zones, double-counted days, and valid markup that produces a different delivery date than checkout.
Repair operational calendars and structured-data generation together. Shared calendar errors can affect large Offer cohorts, so stage changes and retain date-based regression scenarios.
- Identify the exact page, asset, entity or relationship described in this section.
- Inspect the live implementation and retain the observed evidence.
- Compare the observation with the intended meaning and its primary specification.
- Correct any mismatch, then retest the live result.
- Record the accountable owner and review date.
| Case | Meaning | Action |
|---|---|---|
| Universal Monday–Friday | Scope overreach | Use source calendar |
| Warehouse calendar for transit | Wrong authority | Use carrier service days |
| Holiday ignored | False date | Apply exceptions |
| Cutoff after calendar | Wrong sequence | Classify cutoff first |
| Duplicate day count | Extra delay | Centralize calculation |
- Crawl every calendar value.
- Validate parent and type.
- Map authority, origin, and service.
- Calculate boundary dates.
- Repair shared sources.
businessDays defects require structure, authority, calendar, cutoff, exception, and checkout evidence together.