Products
Product State
Meanings of Product States
You may wonder, what do these product states represent, why not just go with an is_active flag?
The answer is that in many ecommerce businesses products may go through different lifecycle stages, which need slightly different handling. Vanilo doesn't enforce any workflow for this, but here's the interpretation of the built-in states, and how they can possibly be handled:
| State | Meaning | Common way of handling the state |
|---|---|---|
draft |
The product data is incomplete | Never display it on the StoreFront, do not allow it in any transaction, but allow editing in Admin |
inactive |
The product data is complete but has not been published yet | Hide from the StoreFront, eventually allow in transactions; eg. backorders, early closed-group sales, etc |
active |
The product is active | Make it available everywhere |
unavailable |
The product is temporarily unavailable; due to supplier issues, legal reasons, quality problems, production blockages or any other reason that prevents the product from being ordered and shipped | Display it on the StoreFront, but disallow new orders |
retired |
The product is permanently unavailable and will never come back to the product range | Do not list it on the StoreFront, but allow opening it when directly accessing its product link. Disallow new orders. |
Difference Between Stock 0 and Unavailable
What is the difference between 0 stock and state to unavailable? Is it just some flag to make a product not buyable but still visible?
The state "unavailable" may cover cases, where a product is on stock, is visible, but can not be ordered.
- Example1: a certain type of product is under the suspect of being contaminated, and the shop needs to verify for batch numbers if they are affected. Until the check is done, the product is temporarily blocked
- Example 2: The manufacturer of the product is having a legal debate and the selling of the product is temporarily suspended
- Example 3: A custom-made wardrobe is in stock but cannot be sold to the end user because it requires final assembly or painting, which is delayed due to a missing special adhesive or a malfunctioning paint-spraying machine.
Retired Products
The "retired" state is generally provided for unlisting products, but going directly to the product page would still show up. This can happen, for example, when in the customer account, the shopper browses an old order and goes to the previously ordered product, which is retired in the meantime.
What is the difference between retiring and deleting products?
Deleting a product will make it go away. In fact, it's soft-delete, so it remains in the DB so that older order items won't break, but the product will not be visible anywhere.
Therefore, if you have ever sold a certain product to your shoppers, it's just better to retire it instead of deleting.