PrestaShop 8: Solving 'Image Not Found' Errors in Product Personalization Uploads

PrestaShop 8 Product Personalization: Troubleshooting "Image Not Found" Errors

Enabling customer image uploads for product personalization is a powerful PrestaShop feature. However, merchants sometimes face a frustrating issue: uploaded images appear "broken" or "image introuvable" (image not found) in the cart. This community insight from the PrestaShop forum details a common scenario on PrestaShop 8 and provides a comprehensive diagnostic and troubleshooting guide from experienced users.

The Problem: Broken Personalization Images

A PrestaShop 8 user, jeanmiche35, reported that customer-uploaded photos for product personalization were not displaying correctly, showing as broken links in the cart. This issue directly impacts the functionality of personalized products and customer satisfaction.

Initial Troubleshooting & Common Pitfalls

Community expert Alexandre Carette initially suggested checking:

  • Folder Permissions: Ensuring write permissions (755 or 777) on critical directories like /img/cms and potentially /upload.
  • PrestaShop Cache: Clearing the cache from the "Performances" section in the back office.
  • Theme Conflicts: Testing with the default Classic theme to rule out custom theme interference.

The original poster confirmed trying these initial steps, including permission adjustments and cache clearing, without resolving the problem.

Advanced Diagnostics: Unpacking "Image Not Found"

When basic troubleshooting didn't suffice, Mediacom87 provided a more detailed diagnostic framework, emphasizing that product file uploads are a native PrestaShop 8 feature. The issue typically arises from how files are processed, stored, or accessed.

Key Areas to Investigate:

  • Server Permissions: Crucially, verify write permissions on the /upload/ directory at your store's root, where customer files are saved.
  • Server Configuration:
    • .htaccess Rules: Custom security rules or directives might block access to uploaded images.
    • WAF (Web Application Firewall): A server-level firewall could interfere with file uploads or access.
  • PHP Upload Limits: Check PHP settings like upload_max_filesize and post_max_size. Images exceeding these limits will fail to save correctly.
  • Theme Compatibility: Even if the file uploads, a non-Classic theme might generate an incorrect URL for displaying the image in the cart.

Systematic Diagnostic Steps:

To accurately pinpoint the problem, follow these steps:

  1. Upload a Small Image: On the product page, upload a small JPG image for personalization.
  2. Add to Cart: Add the personalized product to your cart.
  3. Inspect Broken Image: Right-click the "broken image" icon in the cart and select "Open image in a new tab."
  4. Analyze the Error:
    • HTTP 404 (Not Found): Suggests the file is missing, the URL is incorrect, or there's a URL rewriting issue.
    • HTTP 403 (Forbidden): Indicates the server is preventing access, often due to permissions or .htaccess.
    • HTTP 500 (Internal Server Error): Points to a server-side configuration or execution problem.
  5. Verify File Presence: Check your PrestaShop's /upload/ directory to confirm if the file was physically saved.

The combination of the image's URL, the HTTP error code, and the file's presence in /upload/ provides critical information for diagnosis. Additionally, Alexandre Carette recommended temporarily disabling non-native modules to isolate conflicts if the issue persists.

This community discussion underscores that image upload failures often stem from server environment settings (permissions, PHP limits), PrestaShop configuration (cache), or theme compatibility. A systematic diagnostic approach is crucial for resolving these complex e-commerce challenges.

Start with the tools

Explore migration tools

See options, compare methods, and pick the path that fits your store.

Explore migration tools