# Multi-Stock Location Display

The **Multi-Stock Location Display** feature enhances transparency by showing customers stock availability across multiple locations directly on the storefront. This provides buyers with more detailed information while maintaining the master inventory logic for order allocation.

***

### What’s New

**1) Stock service enhancement**\
The stock service has been updated to return not only the **default stock level** but also stock levels from other configured locations.

**2) Default stock as master**\
While multiple stock locations are now displayed to customers, the **default stock** remains the master stock holder. This means that:

* All order allocations continue to use the default stock.
* The default stock reflects the **sum of all stock locations**.

**3) Frontend display**\
Shoppers can now see availability by location, improving clarity for multi‑warehouse or multi‑store setups.

***

### Benefits

**1) Improved customer confidence**\
By showing stock availability across multiple locations, shoppers can make better purchasing decisions.

**2) Transparency**\
Customers know where stock is held, which is especially useful for regional fulfilment or store pickup.

**3) Reduced support queries**\
Displaying stock details reduces the need for customers to contact support for availability questions.

**4) Seamless stock control**\
Despite displaying multiple locations, the allocation logic remains simple—default stock is still the single source of truth for order processing.

**5) Scalability**\
Supports growth into multi‑warehouse operations without complicating the checkout process.

***

### How It Works

1. Customer views a product on the storefront.
2. The stock service retrieves stock data from all configured locations.
3. The frontend displays both the **default stock** (sum of all) and the breakdown per location.

***

### Summary

The **Multi-Stock Location Display** provides richer stock visibility for customers while keeping stock allocation simple and reliable. Customers see stock across locations, while the system continues to use **default stock as the master stock holder**, ensuring consistency and preventing overselling.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.storefront.co.za/release-notes/enhancements/2025-enhancements/october-2025-enhancements/multi-stock-location-display.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.