> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usebila.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Stock Activity
> Learn how to monitor and audit every inventory movement across your product catalogue on the Bila platform.
The **Stock Activity** log tracks every inventory change — sales, manual adjustments, and corrections — with full timestamps.
Only admins with **Merchant Admin** or **Initiator & Approver** roles can access Stock Activity.
***
## Watch: Managing Stock Activity
***
## Step 1: Open Stock Activity
1. In the left sidebar, click **Product Store**.
2. Select the **Stock Activity** tab — located between **Orders** and **Store Settings**.
The log displays a chronological list of all stock movements across your entire inventory, with the most recent changes at the top.
***
## Step 2: Understand Movement Types
Every stock change is categorised so you can audit your inventory clearly:
| Movement Type | Triggered By | What It Means |
| ------------- | ------------------------ | ---------------------------------------------------------------------------- |
| **Sale** | System — automatic | A customer completed a purchase — stock decreases by the quantity sold |
| **Manual** | Merchant — manual action | A merchant added, removed, or corrected stock directly from the dashboard |
| **Restock** | Merchant — manual action | New inventory of an existing product was added to the catalogue |
| **Return** | System or merchant | Items were added back to inventory following an order cancellation or return |
**Sale** and **Return** movements are triggered automatically by the system — no manual input is needed. **Manual** and **Restock** entries are always initiated by a member of your team and are attributed to the acting admin in the **Performer** field.
***
## Step 3: Read the Stock Activity Log
Each entry in the log includes the following fields:
| Field | What It Shows |
| -------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Date** | The exact timestamp of the stock movement |
| **Product** | The name of the item affected — e.g. `Vanguard Elite – Men's Watch` |
| **Movement Type** | The category of the change — Sale, Manual, Restock, or Return |
| **Delta** | The numerical change in stock — e.g. `+10` for additions, `–1` for sales |
| **Before / After** | A snapshot of stock levels immediately before and after the change — e.g. `0 → 10` |
| **Reference / Note** | The linked Order ID for sales and returns, or the Manual ID and reason note for merchant-initiated changes |
| **Performer** | Whether the change was made by a team member (manual) or the system (automatic) |
The **Before / After** columns are your fastest tool for spotting discrepancies — if the `After` value doesn't match your expected stock level, filter by that product and trace the delta chain from the most recent entry backwards.
***
## Step 4: Filter and Search
Use the tools at the top of the Stock Activity page to locate specific movements quickly:
| Tool | How to Use It |
| -------------- | ------------------------------------------------------------------- |
| **Search bar** | Search by product name or reference ID |
| **All** | Displays every stock movement across your full catalogue |
| **Sales** | Filters to show only customer purchase movements |
| **Restocks** | Filters to show only inventory additions |
| **Manual** | Filters to show only merchant-initiated corrections and adjustments |
| **Returns** | Filters to show only stock restored from cancellations or returns |
For end-of-month reconciliation, combine the **Manual** filter with a date range to review every merchant-initiated stock change in that period — this gives you a clean list to cross-reference against your supplier invoices.
***
## Reading a Delta Entry
Understanding how to interpret the **Delta** and **Before / After** fields together gives you a complete picture of any stock movement:
| Delta | Before | After | What Happened |
| ----- | ------ | ----- | ------------------------------------------------ |
| `–1` | `15` | `14` | One unit sold to a customer |
| `+50` | `0` | `50` | Initial stock added for a new product |
| `+10` | `40` | `50` | Restock received from supplier |
| `–3` | `20` | `17` | Manual correction — e.g. damaged units removed |
| `+2` | `8` | `10` | Return — units restored after order cancellation |
***
## Troubleshooting
| Issue | What to Do |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Stock count doesn't match physical inventory | Filter by the product and review the full delta chain — look for any `Manual` entries without a reason note that may indicate an unrecorded correction |
| A sale is not reflected in Stock Activity | Confirm the order status is `COMPLETED` in your Orders dashboard — pending payments do not trigger a stock movement |
| A restock entry is missing | Check that **Save Changes** was clicked after the adjustment — unconfirmed adjustments are not logged |
| Movement is attributed to the wrong admin | Review the **Performer** field — if the acting admin is incorrect, check whether shared login credentials are in use across your team |
## Next Steps
Make a manual stock adjustment directly from your Products list.
Review the full security log of all admin actions including stock changes.