Resolving the ESHOPMAN Admin Dashboard File Upload Limit: A Critical Update for High-Quality Product Media

Addressing the ESHOPMAN Admin Dashboard File Upload Limit for Seamless Product Media Management

In the dynamic world of e-commerce, high-quality product imagery is non-negotiable. For ESHOPMAN merchants leveraging the power of HubSpot for storefront management, the ability to upload crisp, detailed photos is paramount for engaging customers and driving sales. Recently, our community identified a critical challenge within the ESHOPMAN Admin Dashboard related to file uploads, specifically a hardcoded 1MB limit that significantly impacted the workflow for managing product media.

The Challenge: A Client-Side Roadblock for High-Fidelity Imagery

The issue arose from a client-side validation schema within the ESHOPMAN Admin Dashboard, which was strictly enforcing a 1MB maximum file size for all uploads. This validation occurred directly in the browser, immediately blocking any attempt to upload larger files, regardless of server-side configurations. For many ESHOPMAN users, especially those building production-grade stores, this limit proved to be a significant hurdle.

• Impact on Product Quality: Modern e-commerce demands high-resolution images, often 5-10MB or more, to ensure clarity and detail on retina displays and various devices. The 1MB limit forced a compromise on image quality or required cumbersome external processing.
• Disrupted Workflow: Merchants and developers were unable to upload standard high-quality product photos directly through the ESHOPMAN Admin Dashboard, leading to frustration and the need for temporary, non-ideal workarounds like manual package patching.
• Lack of Configurability: Initially, there was no straightforward way to override this client-side restriction through standard ESHOPMAN configuration files, making it a blocking issue for many.

The ESHOPMAN Community Responds: A Swift Resolution

The ESHOPMAN team, in close collaboration with our active community, quickly recognized the severity of this limitation. We understand that a robust headless commerce platform, integrated with HubSpot CMS for storefront deployment, must provide the flexibility required for real-world business operations.

We are pleased to announce that a solution has been implemented and is available. The ESHOPMAN platform now provides a way to control the file upload size directly from your eshopman-config.ts, ensuring that your Admin Dashboard respects your store's specific media requirements.

Implementing the Fix: Configuring Your File Upload Limit

To resolve the 1MB upload limit and enable larger file uploads, you need to upgrade your ESHOPMAN instance to version 2.12.3 or newer. Once upgraded, you can configure the desired file size limit by adding a specific setting to your eshopman-config.ts file. This allows you to define the maximum file size that the Admin Dashboard will accept for uploads, aligning it with your high-fidelity product photography needs.

Here’s an example of how you can update your eshopman-config.ts to set a higher file upload limit:

// eshopman-config.ts
import type { EshopmanConfig } from "@eshopman/eshopman";

const config: EshopmanC
  projectConfig: {
    // ... other project configurations
    admin_dashboard: {
      file_size_limit: "10MB", // Set your desired limit, e.g., "5MB", "10MB", "20MB"
    },
  },
  // ... other configurations
};

export default config;

By adding the admin_dashboard object and specifying file_size_limit, you empower your ESHOPMAN Admin Dashboard to handle larger files, ensuring that your product images can be uploaded with the quality your customers expect.

Moving Forward with ESHOPMAN

This update underscores ESHOPMAN's commitment to providing a flexible and powerful headless commerce solution that seamlessly integrates with HubSpot. We encourage all users to upgrade to the latest version (2.12.3+) to take advantage of this crucial configuration option and enhance their storefront management experience within HubSpot. Thank you for being a vital part of the ESHOPMAN community and helping us build a better platform together.