Visual Discrepancy: ESHOPMAN Admin Order List Shows Gray Fulfillment Badges After Update

Addressing a Visual Observation in ESHOPMAN Admin Order Management

The ESHOPMAN community has recently observed a specific visual behavior within the ESHOPMAN Admin dashboard concerning order fulfillment status badges. For merchants and administrators leveraging ESHOPMAN’s robust storefront management capabilities within HubSpot, quickly discerning the status of orders is paramount for efficient operations. This insight details a reported visual discrepancy that users might encounter, particularly after updating their ESHOPMAN instance.

The Observation: Gray Fulfillment Status Badges

A key visual cue for order management in the ESHOPMAN Admin is the color-coded fulfillment status badge on the order list. Traditionally, these badges provide an immediate visual signal:

• Red: Indicates an order that is not_fulfilled.
• Orange: Signifies a partially_fulfilled order, or those with partial shipment/delivery statuses.
• Green: Represents orders that are fully fulfilled, shipped, or delivered.

However, an observation has been made where, under specific conditions, these crucial visual indicators on the order list render as a generic gray, regardless of the actual fulfillment status. This means statuses like not_fulfilled or partially_fulfilled, which should stand out, appear indistinguishable from others at a glance.

When Does This Occur?

This visual change appears to manifest after updating an ESHOPMAN instance to version 2.15.x. The critical condition for this behavior is when the view_configurations table is active within the ESHOPMAN setup. While the exact interplay is under community discussion, it suggests a potential conflict or change in how the Admin UI processes and displays status data when certain configurations are enabled.

It's important to note that this visual issue seems to be isolated to the order list view. The order detail header, for instance, continues to map and display fulfillment statuses with their correct, specific colors. This suggests that the underlying data and logic for fulfillment statuses remain accurate; the discrepancy lies primarily in the rendering of the badges on the summary list.

Technical Context for Developers

For ESHOPMAN developers and system administrators, understanding the environment where this behavior has been observed can be helpful:

• ESHOPMAN Core Version: 2.15.2
• ESHOPMAN Admin Dashboard: 2.15.2
• ESHOPMAN UI Library: 4.1.12
• Node.js Version: v25.9.0
• Operating System: Windows 11
• Browser: Chrome

The package versions indicate that this behavior surfaced following an update to the 2.15.x series of ESHOPMAN components. This is a common scenario in rapidly evolving headless commerce platforms built on Node.js/TypeScript, where UI components interact with the Admin API and Store API.

- `@eshopman/eshopman`: 2.15.2
- `@eshopman/admin`: 2.15.2
- `@eshopman/ui`: 4.1.12

Impact on ESHOPMAN Merchants and Operations

For ESHOPMAN merchants managing their storefronts via HubSpot, visual clarity in the Admin dashboard is crucial. A quick scan of the order list allows for rapid identification of orders requiring immediate attention (e.g., unfulfilled orders) versus those that are progressing smoothly. When all fulfillment badges appear gray, this efficiency is hampered, potentially leading to:

• Increased time spent manually checking each order's detailed status.
• A higher risk of overlooking orders requiring urgent action.
• A less intuitive and efficient user experience within the ESHOPMAN Admin, which is designed to streamline operations in a headless commerce setup.

Community Awareness and Next Steps

This observation serves as an important point of awareness for the ESHOPMAN community, particularly for those who have recently updated their instances or are planning to do so. While a direct solution or workaround is not yet broadly established, recognizing this behavior allows users to anticipate and adapt their workflows. It also highlights the dynamic nature of platform updates and the importance of monitoring UI consistency for optimal storefront management.

Staying informed about such community observations ensures that ESHOPMAN users can continue to leverage the platform's full potential for headless commerce, seamlessly integrated with HubSpot CMS for storefront deployment.