Magento - how to add new product status

Magento - how to add new product status

September 5, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento - how to add new product status

Creating New Product Statuses in Magento

If you’re looking to add custom product statuses in your Magento store, you’ve come to the right place. In this guide, we’ll walk you through the steps required to create new status categories that fit your specific business needs.

Understanding Magento’s Core Product Statuses

Before diving into creating new statuses, let’s quickly recap what you’re working with:

  • In Stock: The product is available for purchase.
  • Out of Stock: The product has no remaining inventory and cannot be purchased.
  • Backorder Allowed: The product can be ordered even if it’s out of stock. It will be shipped as soon as it becomes available.

Why Create Custom Product Statuses?

There are plenty of reasons to create custom statuses:

  1. Inventory Management: Track products that are in the process of being prepared for sale.
  2. Product Availability: Indicate when a product is temporarily unavailable but expected back soon.
  3. Special Promotions: Highlight products that are part of limited-time offers.

How to Add New Product Statuses

To create a new status, you’ll need to modify two files:

  1. app/code/core/Mage/Catalog/etc/config.xml
  2. app/design/frontend/default/default/template/catalog/product.list.phtml

Let’s start with the config file.

Step 1: Edit app/code/core/Mage/Catalog/etc/config.xml

Open this file using a text editor like Sublime Text or Atom. Look for the following section:

<catalog_statuses>
    <in_stock translate="label">In Stock</translate>
    <out_of_stock translate="label">Out of Stock</translate>
    <backorder_allowed translate="label">Backorder Allowed</translate>
</catalog_statuses>

To add a new status, simply append it to this list:

<catalog_statuses>
    <in_stock translate="label">In Stock</translate>
    <out_of_stock translate="label">Out of Stock</translate>
    <backorder_allowed translate="label">Backorder Allowed</translate>
    <processing translate="label">Processing</translate> <!-- New status -->
</catalog_statuses>

Replace "Processing" with the name you’d like for your new status.

Step 2: Edit app/design/frontend/default/default/template/catalog/product.list.phtml

This file controls how product statuses are displayed on category pages. Find this line:

<?php if ($statusLabel = $this->getStatusLabel()): ?>
    <span class="label"><?php echo $statusLabel; ?></span>
<?php endif; ?>

Add the following lines just after it:

<?php if ($statusLabel == 'processing'): ?>
    <span class="processing-label">Processing</span> <!-- Custom CSS class -->
<?php endif; ?>

This code checks for your new status and applies a custom CSS class to the product label.

Step 3: Update Your Product Attributes

Now, you can start setting your products to this new “Processing” status in the Magento admin panel under Catalog > Manage Products.

Conclusion

Creating new product statuses is a straightforward process that allows you to better manage and display information about your inventory. Remember to always backup your files before making changes, and test thoroughly after implementing new statuses.

For more advanced customizations like adding new status icons or changing the backend layout, I recommend checking out the Magento Commerce documentation at https://laravelcompany.com/magento-commerce-documentation/.

Happy coding!

Catalog Themes Configuration Orders

Our network