Download Latest Version v2.11.3_ Dependency clean-up source code.tar.gz (34.1 MB)
Email in envelope

Get an email when there's a new version of Medusa.js

Home / v2.11.2
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2025-10-31 10.8 kB
0
v2.11.2_ Product variant images and Index management API source code.tar.gz 2025-10-31 34.0 MB
0
v2.11.2_ Product variant images and Index management API source code.zip 2025-10-31 49.4 MB
0
Totals: 3 Items   83.4 MB 0

Highlights

Product variant images

This release introduces images on product variants. It is now possible to assign images to individual product variants, enabling fully scoped variant-specific photos. In addition to this, a variant can have a thumbnail among its associated images.

The behavior of images is as follows: - Images are added to products - Variant images are chosen among the product images - Upon retrieving variants, the variant images will contain: - Product images that are not associated with any variants - Images that are associated with the variant

For example, let's imagine you have three product images: 1. White t-shirt 2. Black t-shirt 3. T-shirt on a model

You want to share the third image across variants, and have the white image on the white variants and black image on the black variants. To achieve this, you associate the white t-shirt image with the white variants, and the black t-shirt image with the black variants. The third image should have no associated variants.

This in turn would result in the following response on variants:

:::json
{
  "id": "prod_1234",
  "variants": [
    {
      "id": "var_1234",
      "title": "White t-shirt"
      "images": [
        { "id": "img_1234", "url": "http://images.com/white-t-shirt.png" },
        { "id": "img_1234", "url": "http://images.com/t-shirt-on-model.png" }
      ]
    },
    {
      "id": "var_4321",
      "title": "Black t-shirt"
      "images": [
        { "id": "img_1234", "url": "http://images.com/black-t-shirt.png" },
        { "id": "img_1234", "url": "http://images.com/t-shirt-on-model.png" }
      ]
    },
  ]
}

Managing variant images

Two endpoints have been added: - POST /admin/products/:id/variants/:variant_id/images/batch — Batch manage image associations for a specific variant. - POST /admin/products/:id/images/:image_id/variants/batch — Batch manage variant associations for a specific image.

Admin UI

You can manage product variant images from the product page in the admin dashboard. There are two ways to manage these.

From the root-level product page, you can associate a single image with many variants:

CleanShot 2025-10-30 at 10 16 25@2x

From the variant-specific page, you can associate many images with a single variant:

CleanShot 2025-10-30 at 10 17 32@2x

Data model changes

The following are changes to the data models in the Product Module required to enable this feature: - ProductVariant now includes a many-to-many relationship with ProductImage. - A new ProductVariantProductImage pivot entity manages these associations.

Therefore, please make sure to run migrations after upgrading to the new version:

:::bash
npx medusa db:migrate

Index management API

This release adds a new API for managing the index, enabling you to trigger synchronization and retrieve detailed information about the last sync. The update improves visibility and control over the indexing process.

API - GET /admin/index/details — Retrieve index metadata, including entity type, status, last synced key, and last update timestamp. - POST /admin/index/sync — Trigger synchronization from last synced data - Supports optional options: - { strategy: "full" } — Perform a full sync - { strategy: "reset" } — Truncate tables and perform a fresh sync.

Faster price updates

This release brings performance improvements to the Pricing Module, significantly speeding up price list and price set updates. The changes focus on optimizing database queries, reducing redundant computations, and streamlining price normalization and upsert operations.

Features

Bugs

Documentation

Chores

Other Changes

New Contributors

Full Changelog: https://github.com/medusajs/medusa/compare/v2.11.1...v2.11.2

Source: README.md, updated 2025-10-31