# Stock Statuses
## Introduction
**Stock Statuses** are simple text labels that inform customers about product availability. These messages appear on product pages, category listings, and search results to indicate whether an item is in stock, out of stock, available for backorder, or has other inventory conditions. Clear stock status messaging helps manage customer expectations and reduces support inquiries.
## Accessing Stock Statuses Management
{% stepper %}
{% step %}
#### Navigate to Stock Statuses
Log in to your admin dashboard and go to **System → Localization → Stock Statuses**.
{% endstep %}
{% step %}
#### Stock Status List
You will see a list of all defined stock status messages.
{% endstep %}
{% step %}
#### Manage Stock Statuses
Use the **Add New** button to create a new stock status or click **Edit** on any existing status to modify it.
{% endstep %}
{% endstepper %}
## Stock Status Interface Overview
### Stock Status Configuration Fields
Basic Configuration
**Single Field Setup**
* **Stock Status Name**: **(Required)** The text displayed to customers (e.g., "In Stock", "Out of Stock", "Available for Backorder", "Discontinued")
{% hint style="info" %}
**Multi-Language Support**: Stock status names can be translated for each language in your store. When editing a stock status, you'll see language tabs where you can enter translations for each active language.
{% endhint %}
## Common Tasks
### Creating Custom Stock Status Messages
To add specialized inventory statuses:
1. Navigate to **System → Localization → Stock Statuses** and click **Add New**.
2. Enter a clear **Stock Status Name** that accurately describes the inventory condition.
3. For multi-language stores, switch between language tabs to provide translations.
4. Click **Save**. The new status will be available when editing product inventory.
### Setting Up Backorder Status
For products that can be backordered:
1. Create a stock status named "Available for Backorder" or similar.
2. Assign this status to products that accept backorders in the product edit page.
3. Consider adding a note in the product description about backorder timelines.
4. Monitor inventory to ensure backordered items are eventually restocked.
### Managing Out-of-Stock Products
For items temporarily unavailable:
1. Ensure you have an "Out of Stock" status (created by default).
2. Set products to this status when inventory reaches zero.
3. Configure your store to hide out-of-stock products if desired (in store settings).
4. Use the status to trigger customer notifications when items are restocked.
## Best Practices
Status Messaging Strategy
**Customer Communication**
* **Clarity Over Creativity**: Use clear, unambiguous terms that customers immediately understand.
* **Action-Oriented Messages**: Consider statuses that tell customers what to do (e.g., "Pre-order Now", "Contact for Availability").
* **Consistent Terminology**: Use the same status terms across all products to avoid confusion.
* **Visual Indicators**: Complement text statuses with color-coded indicators in your theme (green for in stock, red for out of stock).
Inventory Management
**Operational Efficiency**
* **Minimum Status Set**: Create only the statuses you actually need to avoid clutter.
* **Regular Review**: Periodically review which statuses are being used and remove unused ones.
* **Integration with Workflows**: Align stock statuses with your warehouse management processes.
* **Automatic Updates**: Consider extensions that automatically update stock status based on inventory levels.
{% hint style="warning" %}
**Deletion Warning** ⚠️ Never delete a stock status that is assigned to products. Check the product count in the error message before deletion. Instead, create a new status and reassign products, then delete the old status.
{% endhint %}
## Troubleshooting
Stock status not appearing on product page
**Display Issues**
* **Product Assignment**: Verify the stock status is actually assigned to the product in the product edit page.
* **Theme Template**: Check if your theme template displays stock status (some minimalist themes may omit it).
* **Language Translation**: For multi-language stores, ensure the status has a translation for the current language.
* **Cache**: Clear OpenCart cache to refresh product displays.
Cannot delete a stock status
**Product Dependency Issues**
* **Product Assignment**: The status is assigned to one or more products. Check the error message for the count.
* **Solution**:
1. Create a replacement stock status.
2. Use product filters to find all products using the old status.
3. Edit products to assign the new status.
4. Attempt deletion again.
Inconsistent status display across languages
**Translation Issues**
* **Missing Translations**: Ensure the stock status has translations for all active languages.
* **Language Switching**: Test the product page while switching between languages.
* **Default Language Fallback**: OpenCart uses the default language translation if a translation is missing.
* **Translation Length**: Very long translations might break layout—keep translations concise.
> "Stock statuses are your store's honesty policy in action. Clear availability messaging builds trust, manages expectations, and turns potential frustration into informed purchasing decisions."
---
# 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://docs.opencart.com/admin-interface/system/localization/stock-statuses.md?ask=
```
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.