NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist
ShopUi module
Latest stable
2.8.2
Last release 20 days ago
02 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
226 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.8.1...2.8.2
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.8.1...2.8.2
webpack, eslint, stylelint, sass-embedded and style-dictionary.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.8.0...2.8.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.8.0...2.8.1
@use) provides only its definitions and no longer re-emits its CSS into the consumer's output.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.7.0...2.8.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.7.0...2.8.0
ShopUiConfig::getYvesAssetsNamespaces() and `ShopUiConstants::YVES_ASSETS_NAMESPACE placeholder in the Yves assets URL pattern to the current store name, removing the placeholder for stores not listed.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.6.0...2.7.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.6.0...2.7.0
@shared/<module>/* path alias in the Yves frontend builder to resolve Shared/<Module>/Theme/default sources, with project themes taking precedence over core ones.getAliasList() and the Sass importer to resolve an alias through a list of targets in order, so a project file shadows the core file in scripts and styles alike.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.5.0...2.6.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.5.0...2.6.0
advanced-table-checkbox-cell molecule to render the checkbox atom instead of a native checkbox input to align table checkboxes with the storefront design.checkbox atom to support the indeterminate and dynamically disabled input states and to space the box and the label with a flexbox gap, hiding an empty label.tabindex attribute from the checkbox atom label to provide a single keyboard tab stop per checkbox.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.4.1...2.5.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.4.1...2.5.0
advanced-table-checkbox-cell molecule to render checkboxes in table cells, including selectable rows that fire the advanced-table-selection-change event and a select-all header variant.advanced-table-input-cell molecule to render form inputs with an optional trailing text, such as a unit, in table cells.advanced-table molecule with columns[].head.type and columns[].headCell for custom header cells, columns[].hint for header tooltips, rows[]._row.class and rows[]._row.attributes for row hooks, and the advanced-table__row--selected row state.tooltip-message molecule with hasTrigger, triggerLabel, triggerIcon and triggerAttributes to render an accessible info-icon trigger, introduced the --anchored modifier, and added the trigger, triggerClass, triggerContent and tooltipContent overridable blocks.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.4.0...2.4.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.4.0...2.4.1
app.js grouped by critical and non-critical styles, which changed the order components are initialized in and could break pages such as checkout; components are registered in discovery order again, and app.css keeps the critical-then-non-critical order.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.3.0...2.4.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.3.0...2.4.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.2.1...2.3.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.2.1...2.3.0
update:config script and the typecheck builder setting; the generated tsconfig.yves.json contains only the theme aliases that are actually imported.MainPopup::togglePopup(), MainPopup::replaceContent() and $clone of the main-popup molecule from protected to public.typescript, webpack, stylelint and ts-jest from peerDependencies to devDependencies, added style-dictionary and updated css-minimizer-webpack-plugin to ~8.0.0.test script to builder:test and removed spryker-base-eslint.mjs and spryker-base-stylelint.mjs in favor of inlined lint rules.index.ts files to import style.scss with an explicit file extension.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.2.0...2.2.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.2.0...2.2.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.1.1...2.2.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.1.1...2.2.0
ShopUiConfig::isQaAttributesEnabled() and ShopUiConstants::IS_QA_ATTRIBUTES_ENABLED to allow disabling data-qa test-automation attribute rendering in production, reducing rendered HTML.componentClass and componentAttributes Twig functions to render component CSS classes and attributes directly instead of through macro invocations, and inlined the widget template instead of extending the shared template model, reducing per-component rendering overhead on the product detail page.Fixed use of deprecated clip/word-break CSS properties in visibility and text helper mixins, replacing them with clip-path and overflow-wrap.
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.1.0...2.1.1
clip/word-break CSS properties in visibility and text helper mixins, replacing them with clip-path and overflow-wrap.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.0.2...2.1.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.0.2...2.1.0
package.json defining the module's frontend build tooling dependencies to align with the updated build toolchain used as part of the Angular v22 upgrade.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.0.1...2.0.2
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.0.1...2.0.2
SanitizeXssListener; submitted form data is now sanitised once.Included commits: https://github.com/spryker-shop/shop-ui/compare/2.0.0...2.0.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/2.0.0...2.0.1
ShopUiToLocaleClientBridge::getCurrentLocale() method signature to include the return type declaration.Removed the deprecated cart-items-counter molecule — use the cart-counter molecule instead.
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.5...2.0.0
FrontendBuilder to move the YVES webpack build pipeline into ShopUi, allowing projects to configure source paths and build hooks without maintaining a separate build package.defineConfig() in FrontendBuilder/settings.mts to allow projects to extend or override default source scan paths, icon sprite locations, and pre-webpack build hooks.-base-hook extension opt-in to all ShopUi component SCSS mixins, enabling project-level style customization at a named insertion point without modifying core files.readyCallback() overrides from ShopUi molecules in favor of the init() lifecycle method.cart-items-counter molecule — use the cart-counter molecule instead.readyCallback() to init() in the action-single-click-enforcer molecule — update any project extensions that override readyCallback() in this component.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.4...1.109.5
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.4...1.109.5
max-height constraint to the logo molecule's __image element, preventing the logo from exceeding the intended header height.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.3...1.109.4
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.3...1.109.4
disabled attribute and enableButton() initialization logic from the ajax-add-to-cart molecule to fix flaky compatibility catalog actions robot tests caused by the button being in a disabled state before JavaScript initialized.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.2...1.109.3
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.2...1.109.3
ajax-add-to-cart molecule to prevent quick-add clicks from being silently lost before the web component initializes by rendering the button as disabled until the click handler is attached.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.1...1.109.2
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.1...1.109.2
suggest-search molecule to initialize navigation before dispatching search results event.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.0...1.109.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.109.0...1.109.1
self-service-portal-advanced-table mixin to shop-ui-advanced-table in the advanced-table molecule to align with the module naming convention.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.108.1...1.109.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.108.1...1.109.0
ajax-provider molecule to handle 401 unauthorized responses by parsing the JSON redirect URL and redirecting the user to the login page, supporting session expiry detection for AJAX-driven pages.X-Requested-With: XMLHttpRequest header to all requests made by the ajax-provider molecule to enable server-side identification of AJAX requests.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.108.0...1.108.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.108.0...1.108.1
suggest-search molecule to prevent errors when navigation is unavailable during search event dispatching, improving storefront search stability.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.107.2...1.108.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.107.2...1.108.0
advanced-table molecule to provide a flexible, reusable table component with dynamic column rendering, custom cell types, sortable columns, and pagination support.advanced-table-actions-cell, advanced-table-date-cell, advanced-table-image-cell, and advanced-table-status-cell molecules as dedicated cell renderers for the advanced-table molecule.collapsible-block molecule to provide a native HTML collapsible section component.form-filters molecule to render filter fields for a form.form-active-filters molecule to display and clear active filter values for a form, supporting both select and text field types.select atom to render arbitrary HTML attributes from the attr property.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.107.1...1.107.2
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.107.1...1.107.2
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.107.0...1.107.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.107.0...1.107.1
?? null-coalescing operator with the | default(null) Twig filter in page-layout-main.twig.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.106.3...1.107.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.106.3...1.107.0
SPRYKER_SEARCH_RESULTS interface and dispatchSearchResultsEvent() method to the suggest-search molecule to dispatch a search-results custom event carrying the search term and results count, enabling search statistics tracking.page-layout-main template to register the search-results event in the traceable events configuration and to include the traceable-events-google-analytics molecule for GA4 storefront tracking support.spryker-eco/google-analytics to require-dev and suggest to support GA4 storefront tracking integration.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.106.2...1.106.3
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.106.2...1.106.3
sanitize_xss configuration for the custom CSS setting in shop_ui.configuration.yml to enable allow_safe_elements, ensuring safe HTML elements are preserved during XSS sanitization.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.106.1...1.106.2
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.106.1...1.106.2
helper-color-dark and helper-color-light SCSS mixins in _color.scss to prevent exceptions thrown since version 1.106.1.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.106.0...1.106.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.106.0...1.106.1
input-dropzone molecule to correctly handle file type validation when no accepted formats are configured, preventing false rejections of valid files.input-dropzone molecule to read accepted formats from the input element's accept attribute directly, ensuring consistent behavior with the rendered HTML input.input-dropzone molecule to conditionally render the file upload description only when constraints such as max-count, max-total-size, or accept are provided.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.105.0...1.106.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.105.0...1.106.0
productAttributeVisibility block to the product-item molecule to enable extension points for attribute visibility content.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.104.0...1.105.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.104.0...1.105.0
ShopUiTwigPlugin to enable configurationValue and configurationValues Twig functions in the Yves Twig environment for reading module configuration values in Storefront templates.ShopUiConfig::getModuleConfig(), ShopUiConfig::getModuleConfigValues(), and ShopUiConfig::getModuleConfigValuesCollection() to expose configuration value resolution as public API on the Yves layer.Kernel version dependency.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.103.0...1.104.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.103.0...1.104.0
search-form molecule to forward the data-search-id attribute to ImageSearchAiWidget to support visual search scoping on the storefront.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.102.0...1.103.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.102.0...1.103.0
ProductGroupWidget rendering from the groups blocks in product-card molecule, product-item molecule, and product-list-item molecule default templates — update project-level templates to re-add color group rendering if required.componentName and componentJsName Twig variables to component.twig model to provide convenient access to component class and JS names within template blocks.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.101.0...1.102.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.101.0...1.102.0
page-location-search-params-updater component to enable URL parameter updates for merchant and product offer selection.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.100.3...1.101.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.100.3...1.101.0
empty-state molecule component to display zero-state UI for empty data.globe-location-pin, add, shopping-bag-speed, local-mall) to support zero-state visual elements.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.100.2...1.100.3
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.100.2...1.100.3
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.100.1...1.100.2
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.100.1...1.100.2
ajax-provider.ts to properly handle the optional query parameters.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.100.0...1.100.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.100.0...1.100.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.99.0...1.100.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.99.0...1.100.0
GeneratePathTwigPlugin by introducing URL caching.simple-carousel molecule by extending configuration options and optimizing behavior for a dynamic number of data items.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.98.0...1.99.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.98.0...1.99.0
GeneratePathTwigPlugin to avoid duplication store parameter in url.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.97.1...1.98.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.97.1...1.98.0
EVENT_POPUP_CONTENT_MOUNTED event for main-popup.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.97.0...1.97.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.97.0...1.97.1
remote-form-submit condition for missed container.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.96.1...1.97.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.96.1...1.97.0
ajax-provider.ts for using default and dynamic query params together.main-popup.scss with new auto and scroll-inside-content modificators.endless-scroll for using json response.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.96.0...1.96.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.96.0...1.96.1
highlighted for list.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.95.0...1.96.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.95.0...1.96.0
imageAltText to the card.twig molecule.card.twig molecule to pass image alt text to the lazy-image.twig molecule.image-carousel.twig molecule to pass image alt text to the lazy-image.twig molecule.product-item.twig molecule to set new alt text transfer property highest priority.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.94.0...1.95.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.94.0...1.95.0
main-popup.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.93.2...1.94.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.93.2...1.94.0
DropzoneType.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.93.1...1.93.2
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.93.1...1.93.2
onTargetClick for molecule action-single-click-enforcer to prevent duplication of the request on the link click.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.93.0...1.93.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.93.0...1.93.1
product-item.twig to fix an issue with missing isSspService method exception.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.92.0...1.93.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.92.0...1.93.0
isSpriteGenerationEnabled property to icon atom to allow to use generated SVG sprite.isSpriteGenerationEnabled property to icon-sprite atom to not render SVG as an HTML.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.91.0...1.92.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.91.0...1.92.0
product-item.twig.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.90.0...1.91.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.90.0...1.91.0
initial-mount attribute to the remote-form-submit molecule to control the component's mount.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.89.0...1.90.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.89.0...1.90.0
EVENT_POPUP_CLOSED event to the main-popup molecule.replaceContent method to the main-popup molecule.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.88.1...1.89.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.88.1...1.89.0
as-provider-trigger support in ajax-form-submitter` component.dynamic-params support in ajax-provider component.input-dropzone component.$setting-zi-under-layer variable in _z-index.scss.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.88.0...1.88.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.88.0...1.88.1
default/components/molecules/product-item/product-item.twig Twig template to avoid throwing an exception when data.product.attributeMap is null.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.87.1...1.88.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.87.1...1.88.0
input-dropzone component.lazy-image with default placeholder for background view.close-popup-selector attribute for main-popup component.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.87.0...1.87.1
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.87.0...1.87.1
banner molecule to trim title and subtitle.user, phone and mail to icon-sprite.outer-spacingless for box.column for grid.lazy-image condition for replacing image.Included commits: https://github.com/spryker-shop/shop-ui/compare/1.86.0...1.87.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.86.0...1.87.0
Adjusted elements' text to background contrast at:
button.scsslink.scss.breadcrumb-step.scss.navigation-icon-list.scss.pagination.scss.simple-carousel.scss._typography.scss._color.scss._text.scss.Improved accessibility for the form molecule.
Adjusted elements' spacing at list.scss.
Adjusted UI at 'menu.scss'
Added 'aria-label' attribute to the:
suggest-search molecule.ajax-add-to-cart molecule.formatted-number-input molecule.search-form molecule.suggest-search molecule at suggest-search.ts.Introduced new attribute input-aria-label for suggest-search molecule to improve accessibility
Introduced new required attribute parent-class-name for suggest-search molecule to improve keyboard accessibility
Introduced 'viewportUserScaleable' variable to control meta viewports' user-scalable param at the page-blank.twig template.
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.85.0...1.86.0
Included commits: https://github.com/spryker-shop/shop-ui/compare/1.85.0...1.86.0
input-dropzone component.icon-sprite.status component.form.twig.One column per quarter.