Skip to main content

Out-of-Stock Delay Settings

When customers order products that are temporarily out of stock, the module adds extra days to the delivery estimate to account for restocking time. This guide explains how to configure those extra days at every level — from a store-wide default down to a single product combination.

⚙️ When OOS Days Apply​

Extra OOS days are added to a delivery estimate only when all of the following are true:

  • The product has zero stock
  • PrestaShop allows sales without stock (backorders enabled on the product)
  • The product is not excluded from Estimated Delivery
  • The product has no specific restock date (Available Date) set
  • The product has no release date set
Exceptions that disable OOS days

OOS days are ignored when a product has a restock date, a release date, or Undefined Delivery enabled — the module uses those more specific values instead. Setting ED_IGNORE_OOS_DAYS_CUSTOM also disables OOS days for customizable products.

📊 Priority Hierarchy​

The module evaluates OOS days in order from most specific to least specific. The first non-zero value found wins:

1. Combination level    ← highest priority
2. Product level
3. Entity level         (category OR supplier OR manufacturer — one at a time)
4. Global level         ← fallback
Zero means "inherit"

Setting a level to 0 does not mean "no extra days" — it means "skip this level and check the next one." To add zero extra days for a product, disable OOS days entirely in the module settings.

🌍 Global OOS Setting​

The global setting is the fallback used when no more specific rule applies.

  1. Go to Back Office → Estimated Delivery → Section 2.3
  2. Find Extra delay for products Out of Stock
  3. Enter the number of days (e.g. 5) or a range (e.g. 3-7)
  4. Save

Range format (3-7) creates a delivery window — "Estimated delivery: January 15–22" — instead of a single date. Range input is currently supported for the global setting only.

🏢 Entity-Level OOS Settings​

Entity-level settings let you assign OOS days to a group of products at once, based on one of three groupings: category, supplier, or manufacturer. Only one method is active at a time.

Choosing the entity method​

In Section 2.3, find "Select the method" and choose one:

MethodBest for
CategoryStores where restocking time varies by product type
SupplierDropshipping stores or stores with multiple suppliers
Manufacturer / BrandStores where manufacturers control restocking
Only one method can be active

Switching the method changes which entity values the module reads for all products. Configure only the method that matches your workflow.

Configuring by category​

  1. Select Category from the method dropdown
  2. Use the category tree to navigate your store structure
  3. Enter OOS days for each category
  4. Products use their default category for lookups

Example:

Electronics  →  7 days  (complex supply chain)
Clothing     →  3 days  (local warehouse)
Accessories  →  5 days

Configuring by supplier​

  1. Select Supplier from the method dropdown
  2. Choose a supplier from the list
  3. Set OOS days for that supplier
  4. All products from that supplier inherit the setting

Example:

Local Supplier A      →  2 days
International Supplier B  →  14 days
Dropship Partner C    →  7 days

Configuring by manufacturer/brand​

  1. Select Manufacturer / Brand from the method dropdown
  2. Choose a manufacturer from the list
  3. Set OOS days for that brand
  4. All products from that manufacturer use the setting

📦 Product-Level OOS Setting​

Product-level overrides all entity and global settings.

  1. Go to Catalog → Products and edit the product
  2. Find the Estimated Delivery section
  3. Set Out of stock additional days
  4. Save

A value of 0 means "inherit from entity/global." Any value above 0 takes priority.

🎨 Combination-Level OOS Setting​

For products with combinations (size, color, etc.), each combination can have its own OOS days — the highest priority in the hierarchy.

  1. Edit a product with combinations
  2. Scroll to Set Estimated Delivery settings by combination
  3. Find the OOS Days column
  4. Set the value per combination

A value of 0 falls back to product-level settings.

Example — T-Shirt with sizes:

Size S, Color Red    →  0   (uses product default of 5 days)
Size M, Color Blue   →  0   (uses product default)
Size XXL, Color Black  →  14 days  (rare size, longer restock)

💡 Common Configuration Examples​

Electronics store with weekly supplier deliveries​

  • Global: 7 days
  • Supplier "TechDistributor": 3 days (faster)
  • Product "Gaming Monitor XL": 14 days (special order)

Artisan shop with rare materials​

  • Global: 10 days
  • Manufacturer "LocalArtisan": 21 days (handmade)
  • Combination "Gold variant": 30 days (combination override)

Dropshipping with multiple regions​

  • Global: 10 days
  • Category "US Products": 5 days
  • Category "EU Products": 7 days
  • Category "Asia Products": 21 days

🔍 Troubleshooting​

OOS days not appearing on the frontend​

Check all of the following:

  • Product stock quantity is 0
  • PrestaShop "sales when out of stock" is enabled for the product
  • Product is not excluded from Estimated Delivery (check Product Edit → ED section)
  • Product has no restock date or release date set
  • The entity method in Section 2.3 is set correctly
  • The OOS days value at the active entity level is greater than 0

Wrong number of extra days shown​

Work down the hierarchy from top:

  1. Check combination-level OOS days first
  2. Check product-level (0 means it inherits)
  3. Check entity level — verify the active method matches what you configured
  4. Check global setting as last fallback

Remember: the first non-zero value in the hierarchy is used.

Category/supplier/manufacturer settings have no effect​

Verify in Section 2.3 that the "Select the method" dropdown is set to the entity type you configured. If it's set to "Category" but you entered supplier values, the supplier values will be ignored.

✅ Final Checklist​

  • Global OOS days set in Section 2.3 (store-wide fallback)
  • Entity method selected (Category, Supplier, or Manufacturer)
  • OOS days entered for each entity that needs a different delay
  • Product-level overrides applied for exceptions
  • Combination-level values set for variants with unique restocking times
  • Tested on a product with zero stock to confirm correct delay appears
Why are OOS days not showing for my out-of-stock product?

OOS days only apply when all conditions are met: the product has zero stock, backorders are enabled in PrestaShop for that product, the product is not excluded from Estimated Delivery, and it has no specific restock date or release date set. Check each condition in turn.

What does setting OOS days to 0 mean at the product level?

A value of 0 does not mean zero extra days — it means skip this level and inherit from the next one in the hierarchy. To effectively give a product zero OOS delay, you would need to disable the OOS days feature entirely in the module settings.

Can I use both category and supplier OOS days at the same time?

No. Only one entity method can be active at a time — category, supplier, or manufacturer. You choose the method in Section 2.3 and configure values only for that method. Values set for inactive methods are stored but ignored until that method is selected.

Can I set a delivery range like 3 to 7 days for out-of-stock products?

Yes, but only at the global level. Entering a value like 3-7 in the global OOS setting creates a delivery window rather than a single date — for example, Estimated delivery: January 15 to 22. Range input is not available at the product or combination level.

Which OOS days value wins if I have rules at multiple levels?

The hierarchy goes: combination level (highest priority), then product level, then entity level (category, supplier, or manufacturer), then global (lowest priority). The first non-zero value found in that order is used. A zero at any level means skip to the next.

🆘 Need Help?​