Troubleshooting Product Option Display Issues in ESHOPMAN Admin

At Move My Store, we understand the critical role robust product management plays in the success of any e-commerce operation powered by ESHOPMAN. Our platform, designed as a powerful headless commerce solution integrated seamlessly with HubSpot, empowers merchants to manage complex product catalogs and deploy dynamic storefronts via HubSpot CMS. Central to this is the ability to define and manage product-specific options and variants, offering customers a tailored shopping experience.

Recently, a valuable community member brought to light an important observation regarding the display of newly added product-specific option values within the ESHOPMAN Admin interface. This insight highlights a scenario where new values, once added to a product option, are not immediately reflected or displayed on the associated product's editing page. This can lead to confusion and hinder efficient product management for merchants utilizing ESHOPMAN's comprehensive features.

Understanding the Reported Issue

The core of the issue lies in the ESHOPMAN Admin's handling of product-specific option values. While ESHOPMAN allows for the creation and modification of product options, a specific workflow seems to prevent newly added values from appearing where expected. This behavior was observed during development on a feature branch focused on enhancing global product option management within ESHOPMAN, indicating a potential area for refinement in how the Admin API interacts with the storefront management UI.

Steps to Reproduce the Behavior:

1. Initial Product Option Setup: Begin by adding a product-specific option along with some initial values directly through the Product editing page in your ESHOPMAN Admin (e.g., /app/products/prod_XXX). This initial setup typically functions as expected, displaying the values correctly.
2. Adding New Values via Product Option Page: Navigate away from the product page to the dedicated Product Option management page (e.g., /app/product-options/opt_XXX). Here, add one or more new values to the existing product-specific option.
3. Returning to Product Page: Go back to the original Product editing page (/app/products/prod_XXX). Open the "Manage Product Options" modal, which allows you to view and select options for the product.
4. Observation: Upon clicking the select input for the product-specific option, the newly added values from step 2 are not displayed in the list. Only the values initially added in step 1 are visible.

Technical Context and Impact

This behavior, while seemingly minor, can significantly impact the workflow for merchants and developers managing product variants and options. ESHOPMAN is built on a robust Node.js/TypeScript foundation, leveraging powerful APIs for both administration and storefront operations. The reported issue points to a potential caching or data synchronization discrepancy between different sections of the ESHOPMAN Admin UI, specifically affecting how product option data is refreshed and presented across various views.

The environment where this was observed included Node.js v24.12.0, a PostgreSQL database (version 16.2), and a macOS operating system. These details are crucial for our ESHOPMAN development team to pinpoint and address the root cause, ensuring the seamless operation of product management features across all supported environments.

Expected vs. Actual Behavior

• Expected Behavior: When a new product-specific option value is added, regardless of whether it's done directly on the product page or the dedicated product option page, it should be immediately displayed and selectable within the "Manage Product Options" modal on the related product page.
• Actual Behavior: New values added via the dedicated Product Option page are not reflected on the product's editing page, creating a disconnect in the administrative experience.

Community insights like this are invaluable to the continuous improvement of ESHOPMAN. They help us ensure that our platform remains stable, intuitive, and highly functional for all users, from developers leveraging the Admin API to merchants managing their storefronts in HubSpot. We appreciate the detailed report and encourage our community to continue sharing their observations, helping us refine ESHOPMAN for an even better headless commerce experience.