Product Details Page changelog

July 30, 2026

Product Details Page v3.3.0

The Product Details Page drop-in has been updated with the following changes:

New features

• Bundle option quantities: Bundle options that allow quantity editing now render a quantity control per selected option value, driven by the canEditQuantity flag from the option’s product data. The single monolith quantity control is hidden for bundle products so shoppers no longer see two conflicting quantity inputs (#78).

Fixes

• Accessibility: Made the main gallery image keyboard-operable so pressing Enter or Space opens the image preview overlay, WCAG 2.1.1 (#85). Marked the product name and “Details” section title as real headings instead of plain text, so screen reader users can navigate to them by heading, WCAG 1.3.1 (#87).

June 10, 2026

Product Details Page v3.2.0

Improvements and fixes

• Gallery crossfade on option change: When a configurable option is selected, the ProductGallery preloads variant images off-DOM via Image.decode() and crossfades the carousel to the new images (~180 ms) once they are paint-ready, eliminating the visible flicker that occurred when variant image URLs were remounted on every swatch click. If the URL set is unchanged, the listener short-circuits to the existing fast path with no delay (#66).

Infrastructure

• Node.js 22 LTS: The package now builds and distributes using Node.js 22 LTS. The engines.node constraint has been removed as this drop-in targets browser environments exclusively.

April 30, 2026

Product Details Page v3.0.3

The Product Details Page drop-in has been updated with the following changes:

• Number attribute formatting: The ProductAttributes container accepts a new formatValue prop for custom formatting of numeric attribute values. This allows merchants to control the precision and display format of numeric custom attributes (for example, weight, dimensions, or product-specific measures) so that values match the display precision configured in Commerce Admin instead of rendering with raw database precision (for example, displaying 1.25 instead of 1.2500000000). Implement the prop with a formatter function that receives the raw value and returns the formatted string (#65).

March 24, 2026

Product Details Page v3.0.2

The Product Details Page drop-in has been updated with the following changes:

• Video support - Out-of-the-box video support in the ProductGallery container. The container now accepts a videos prop: use videos={true} or videos={{ position: 'last' }} for videos after images, or videos={{ position: 'first' }} for videos before images; omit or set videos={false} for backward compatibility. Supports direct video files (for example, .mp4, .webm), YouTube, Vimeo, and AEM Assets. The CarouselMainImage and CarouselThumbnail slots receive mediaType (‘image’ | ‘video’) and previewUrl for custom rendering ( #57 ). Includes the boilerplate integration ( #1100 ).
• ProductOptions transformer prop - A new transformer prop on the ProductOptions container lets you modify product options data before rendering, enabling conversion of dropdown options to radio swatches (text, image, or color) at the container level ( #51 ).
• getProductsData API - A new getProductsData API method for the Quick Order (B2B) drop-in, using the same data model and GraphQL fragment as getProductData ( #56 ).

February 17, 2026

Product Details Page v3.0.1

The Product Details Page drop-in has been updated with the following changes:

• Downloadable products support - Added support for downloadable product options directly on the PDP, allowing customers to view and select downloadable links and samples ( #50 ).
• Options transform prop - New transform prop centralizes options transformation in product-transform for consistent option handling.
• Options transformer prop - New transformer prop enables custom option type conversion with robust error handling for advanced product configuration scenarios.
• Options validation fix - Added length check to optionsUIDs to prevent errors when handling products with no selectable options ( #53 ).
• Values validation - Added safety check to prevent errors when product option values array has no entries ( #42 ).

January 8, 2026

Product Details Page v3.0.0

Major version upgrade with tier pricing support and improved rendering. The Product Details Page drop-in has been updated to include the following changes:

• Tier pricing support - Products with quantity-based discount pricing now display tier pricing information, helping customers understand bulk purchase savings ( #37 ).
• Product attributes rendering - Product attributes now render properly in the product detail view, ensuring all product information displays correctly ( #47 ).
• Revised Adobe Commerce Drop-in License Agreement - Updated license agreement to current terms. Drop-ins are now exclusively licensed for Adobe Commerce as a Cloud Service (ACCS) and Adobe Commerce Optimizer (ACO). Use on on-premise or Platform-as-a-Service (PaaS) deployments is not permitted under the license agreement ( #46 ).

October 14, 2025

Product Details Page v1.3.5

The Product Details Page drop-in has been updated to include the following changes:

• Gift card products now supported: You can now sell gift cards with full functionality including sender/recipient information, custom messages, preset or custom amounts, and validation rules. All form fields and error messages support internationalization ( #28 , #36 , #40 , #41 ).
• Global locale support: The initialize function now accepts a globalLocale option for consistent multi-language support across product attributes, pricing, dates, and currency formatting ( #38 ).
• Better swatch accessibility: Swatch and picker components now use unique IDs that combine attribute and option identifiers. This prevents duplicate name attributes and includes enhanced aria-label support for screen readers.
• GraphQL updates: Upgraded to @adobe-commerce/fetch-graphql v1.2.0 and added the getFetchGraphQlHeader method for better header management and inspection ( #39 ).
• Smarter attribute handling: Special attributes like ac_giftcard now parse JSON properly, transform snake_case to camelCase for validation rules, and handle malformed data gracefully ( #28 ).
• Carousel keyboard navigation: Arrow key handlers in the Carousel component no longer prevent default behavior, improving accessibility and native keyboard navigation ( #28 ).
• Better test coverage: Added comprehensive end-to-end tests for gift card and configurable products using both standalone and container-based approaches ( #43 ).

June 25, 2025

Product Details Page v1.2.0

• You can now fully replace rendered images in the PDP drop-in component, enabling integration with custom asset sources like AEM Assets.
• Added support for updating product options and quantities directly from the cart, streamlining the editing process for configurable products.
• Resolved an issue where overriding the Attributes slot did not render custom content as expected.
• Fixed a CSS issue where the image zoom close icon appeared too large on product detail pages.
• Fixed an issue where the close button was not being displayed correctly.