Athenian Custom Stock Statuses
product details.
Athenian Custom Stock Statuses upgrades WooCommerce availability messaging with custom stock statuses, lead-time details, ship windows, color-coded badges, variation-specific messaging, add-to-cart controls, and import/export workflows. It helps merchants explain real fulfillment timelines clearly, reduce customer confusion, and manage nuanced inventory conditions more professionally. It is designed as a focused module within the broader Athenian Platform,…
Admin Custom Stock Statuses extends WooCommerce’s native stock-status workflow so store operators can define richer product availability states beyond the default In stock, Out of stock, and On backorder labels.
Instead of relying on custom fields, theme snippets, hard-coded product messages, or disconnected fulfillment notes, the plugin adds custom availability definitions directly into WooCommerce’s stock-status options for products and variations. Each status can include a customer-facing label, explanatory details, lead-time copy, optional ship-window metadata, badge color, and an optional add-to-cart restriction.
This is especially useful for stores with made-to-order products, vendor-sourced inventory, seasonal restocks, warehouse transfer workflows, supplier lead times, variation-specific fulfillment windows, or products that should remain visible but not currently purchasable.
Within the Athenian Platform, Admin Custom Stock Statuses fits as a catalog and inventory communication layer, connecting product availability, merchandising, customer expectations, import/export workflows, product filtering, APF storefront behavior, Shipment Manager, Notify Back in Stock, Pricing & Inventory Control, vendor routing, and product-admin operations.
How Athenian Custom Stock Statuses fits the Athenian Platform
Platform role: Athenian Custom Stock Statuses is a focused capability in the Fulfillment, Shipping & Production Operations and Storefront, Merchandising & Product Data layer. Its primary scope covers Inventory, Assets & Costing and Product Data & Catalog Management while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian Custom Stock Statuses is designed to work inside a WordPress and WooCommerce operating environment where storefront, customer, order, identity, payment, fulfillment, automation, and reporting context can remain connected across relevant modules instead of being trapped in isolated add-ons.
From module to operating platform: Athenian Brands organizes the ecosystem in four connected layers: Platform Kernel and Platform Core foundations; focused capability plugins; implementation and integration services; and operating brands such as PrintGhost.ai, Athenian Marketplace, Athenian Academy, and Athenian Unÿa that apply the same patterns to real business workflows.
Commerce Catalog & Inventory
Turn WooCommerce Stock Status Into Clear Availability Messaging
Admin Custom Stock Statuses extends WooCommerce with custom availability
labels, fulfillment details, lead-time messaging, shipping windows,
badge colors, and optional add-to-cart restrictions for products and
variations with more complex availability states.
| Status Layer | Operational Value |
|---|---|
| Native Stock Options | Adds custom statuses into WooCommerce stock-status dropdowns instead of creating a disconnected product-message system. |
| Status Definitions | Stores labels, details, lead times, min/max ship-day windows, badge colors, and add-to-cart restriction flags. |
| Built-In Defaults | Provides enriched metadata for WooCommerce’s native instock, outofstock, and onbackorder states. |
| Custom Availability Language | Supports operational statuses such as Built to Order, Ships from Vendor, Warehouse Transfer, Seasonal Restock, or Availability Varies. |
- Stores custom status definitions in the
custom_stock_statusesoption. - Uses the native WooCommerce product and variation meta key
_stock_status. - Supports machine-readable status keys with customer-facing labels and storefront-ready metadata.
- Keeps richer availability communication tied to WooCommerce’s existing product-management workflow.
Availability Enforcement
Display Accurate Fulfillment Context and Block Purchases When Needed
The plugin converts each product or variation stock status into storefront
messaging with badge colors, details, lead-time lines, and add-to-cart
rules, while protecting restricted products through both frontend UI
behavior and server-side validation.
Show badges, details, lead times, and fulfillment windows
Expose selected variation availability through WooCommerce variation payloads
Disable add-to-cart visually and validate restrictions server-side
| Storefront Layer | How It Helps |
|---|---|
| Availability Output | Filters WooCommerce availability text to include the configured stock badge, explanation, and lead-time details. |
| Variation Payloads | Adds custom stock details to selected variation data so customers can see the exact availability state for each option. |
| Button State | Frontend JavaScript can disable native WooCommerce add-to-cart buttons and APF-style cart CTAs when the selected status is restricted. |
| Server Validation | Uses WooCommerce add-to-cart validation to block restricted statuses even if a user bypasses the frontend UI. |
- Uses hooks such as
woocommerce_get_availability,woocommerce_available_variation, andwoocommerce_add_to_cart_validation. - Frontend behavior reads localized state from
window.APF_CSS_FRONTorwindow.ACSS_FRONT. - Supports native WooCommerce variation events such as
found_variation. - Includes APF-style selectors such as
.apf-add-to-cart,.apf-cart-cta, and[data-apf="common"].
Catalog Operations
Manage Availability Definitions, CSV Workflows, and Product Admin Filtering
Admin Custom Stock Statuses adds a WooCommerce admin screen for defining
custom status rows, supports product and variation save behavior, normalizes
stock status values during CSV import/export, and adds product-list filtering
so catalog teams can quickly find items by operational availability state.
| Admin Layer | Operational Purpose |
|---|---|
| Status Manager | Adds a WooCommerce submenu where managers can create and edit custom stock status definitions. |
| Product Save Support | Persists custom stock status keys to simple products and variations using WooCommerce’s native stock status model. |
| Import / Export | Normalizes incoming stock status labels or keys during import and exports stored stock status values for catalog workflows. |
| Product List Filtering | Adds an admin product-list dropdown for filtering products by selected _stock_status value. |
Built for real catalog operations:
this plugin helps product teams standardize availability language while
preserving WooCommerce compatibility across product editing, variations,
CSV workflows, product-list review, and storefront messaging.
- Uses WooCommerce hooks such as
wc_get_product_stock_status_options,woocommerce_product_stock_status_options,woocommerce_process_product_meta, andwoocommerce_save_product_variation. - Supports import/export hooks such as
woocommerce_csv_product_import_preformatted_data,woocommerce_product_import_inserted_product_object, andwoocommerce_product_export_product_column_stock_status. - Adds admin filtering through
restrict_manage_postsandpre_get_posts. - The reviewed package includes both the active procedural implementation and an unwired modular
ACSSclass-based implementation, so future refactoring should standardize the canonical loader and option names. - Builds toward REST status definitions, WP-CLI import/export tools, bulk-edit support, dedicated variation-status blocks, status transition notifications, Notify Back in Stock integration, Shipment Manager integration, and structured stock-status analytics.