14.0.0

PWA Studio Release 14.0.0

NOTE:
This changelog only contains release notes for PWA Studio and Venia 14.0.0
For older release notes, see PWA Studio releases.

Highlights

The 14.0.0 release of PWA Studio provides customers with many accessibility improvements for keyboard and screen-reader access, as well as several bug fixes. Full details are described below.

Accessibility Updates

• Bug: [4195][] — Only one folder should be remained open when navigating the control from profile to minicart or viceversa

Additional fixes

• Story: 4196 — Updated Tailwind to V3
• Bug: 4207 — yarn install broken after #4191
• Bug: 4235 — Search products by category from searchBar is working according to searched text.
• Bug: 4180 - Layered navigation Options are not visible when no results are available
• Bug: 4194 — Thumbnail Images are getting are now not hidden due to PR
• Bug: 4221 — Broken Sign-in following 13.3.0 is fixed
• Bug: 48 — Exception causes error on PWA build is resolved
• Bug: 4221 — mergeCarts GraphQl Error is resolved
• Bug: 4210 - Version updated in extension.
• Bug: 22 — PWA Upward connector throwing exception resolved
• Bug: 4229 — Order statuses are decoupled from the back-end
• Bug: 4231 - Unable to sign-In using TAB/ Mouse Click button from Sign in Page is resolved
• Bug: 49 — PWA metapackages should support PHP8.3
• Bug: 28 — Unable to complile local code with venia-sample data package in local now resolved
• Bug: 4183 — Products not found using URL key is not resolved
• Bug: 4240 — GraphQL cacheable requests always have "Authorization Bearer" header is now changed to only for non cached pages
• Bug: 4227 — Experience platform connector extension missing parent sku is now added

14.0.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 14.0.0 release of these pages on desktop and mobile devices.

Desktop scores

	Home Page	Product Category	Product Details	Search Results
Desktop
Performance
Accessibility
Best Practices
SEO
PWA

Mobile scores

	Home Page	Product Category	Product Details	Search Results
Mobile
Performance
Accessibility
Best Practices
SEO
PWA

Known issue

When a user logs out, that user's local storage session persists. As a result, the cart ID from the logged out user is retrieved and given to the guest user on the computer. This causes the following error when the guest user tries to check out: An error has occurred. Please check the input and try again. To resolve this issue, try disabling graphql session sharing as described in the GraphQL documentation on session cookies here: https://devdocs.magento.com/guides/v2.4/graphql/authorization-tokens.html#session-cookies.

Upgrading from a previous version

Use the steps outlined in this section to update your scaffolded project from 13.3.0 to 14.0.0.
See Upgrading versions for more information about upgrading between PWA Studio versions.

Updated package dependencies

Open your package.json file and update the PWA Studio package dependencies to the versions associated with this release.
The following table lists the latest versions of each package as of 14.0.0. The bolded versions with an asterisk (*) are the packages that were updated from PWA Studio 13.3.0.

NOTE:
Your project may not depend on some packages listed in this table.

[UPDATE THIS TABLE WITH THE LATEST VERSIONS OF EACH PACKAGE]

Package	Latest version
babel-preset-peregrine	1.2.3
create-pwa	2.4.6*
experience-platform-connector	1.0.6*
upward-security-headers	1.0.15*
venia-sample-backends	0.0.10
venia-sample-eventing	0.0.7*
venia-sample-language-packs	0.0.15*
venia-sample-payments-checkmo	0.0.13*
pagebuilder	9.2.1*
peregrine	14.2.1*
pwa-buildpack	11.4.3
pwa-theme-venia	2.4.0*
upward-js	5.3.2
upward-spec	5.2.1
venia-concept	14.0.0*
venia-ui	11.3.0*
magento2-pwa	0.7.2*
magento2-pwa-commerce	0.0.4*
magento-venia-sample-data-modules	0.0.5*
magento-venia-sample-data-modules-ee	0.0.4*
magento2-upward-connector	2.0.4*
upward-php	2.0.3*

13.3.0

PWA Studio Release 13.3.0

Full Changelog: release/13.2...v13.3.0

NOTE:
This changelog only contains release notes for PWA Studio and Venia 13.3.0
For older release notes, see [PWA Studio releases][].

Highlights

The 13.3.0 release of PWA Studio provides customers with many accessibility improvements for keyboard and screen-reader access, as well as several bug fixes. Full details are described below.

Accessibility Updates

• Bug: 4172 — Reading wrong quantity into sub-folder of My account even when havnig atleast 1 item or more or zero has been fixed.
• Bug: 4131 — Once the account is created and the logged in users are announced as "Hi " and the moment you press tab it highlight the area and announces as "Toggle my account menu button expanded"

Additional fixes

• Story: 4173 — Price filter is now showing currency symbol
• Story: 4090 — Added additional user_errors parameter for cart addition and show error message if reported by Adobe Commerce.
• Bug: 43 — EAV attribute option loading Performance Issue resolved
• Bug: 4124 — Region is required in PWA even if this option is disabled in Magento has been fixed
• Bug: 41 - System is able to navigate to layered URL based on search term
• Bug: 4168 — System is able to navigate to layered URL based on search term
• Bug: 4133 — User is able to access category/subcategory pages even while active search
• Bug: 4174 — Error has been fixed on shipping address page to complete checkout for guest and registered user
• Bug: 4143 — Duplicate Queries were fired multiple times at time of load of page but after fix applied it is resolved
• Bug: 40 — User is able see checkmo option when checkmo checkout configuration is done for selceted country
• Bug: [32][] - The system was thowing error with prex extension while adding the product to cart but after user can add product without any error with or without prex extension.
• Bug: [113][] — The system was thowing error with prex extension while adding the product to cart but after user can add product without any error with or without prex extension.
• Bug: [4135][] — Error message has been updated acording to action on Edit Item popup while updating unavailable quantity.
• Bug: 38 - Total number of iteam quantity is displayed as per configuration selected in backend
• Bug: [4149][] — Total number of iteam quantity is displayed as per configuration selected in backend
• Bug: 21 — Error occurs when Runtime exception is thrown in vendor/magento/module-upward-connector/Model/PageType.php is resolved
• Bug: 4129 — Image is rendered on wrong pages when parallax is used on page builder.

New Contributors

• @rafaelstz made their first contribution in #4040
• @Tarun50745 made their first contribution in #4102
• @glo80771 made their first contribution in #4094
• @jeff-matthews made their first contribution in #4146

13.3.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 13.3.0 release of these pages on desktop and mobile devices.

Desktop scores

	Home Page	Product Category	Product Details	Search Results
Desktop
Performance
Accessibility
Best Practices
SEO
PWA

Mobile scores

	Home Page	Product Category	Product Details	Search Results
Mobile
Performance
Accessibility
Best Practices
SEO
PWA

Known issue

When a user logs out, that user's local storage session persists. As a result, the cart ID from the logged out user is retrieved and given to the guest user on the computer. This causes the following error when the guest user tries to check out: An error has occurred. Please check the input and try again. To resolve this issue, try disabling graphql session sharing as described in the GraphQL documentation on session cookies here: https://devdocs.magento.com/guides/v2.4/graphql/authorization-tokens.html#session-cookies.

Upgrading from a previous version

Use the steps outlined in this section to update your scaffolded project from 13.2.0 to 13.3.0.
See Upgrading versions for more information about upgrading between PWA Studio versions.

Updated package dependencies

Open your package.json file and update the PWA Studio package dependencies to the versions associated with this release.
The following table lists the latest versions of each package as of 13.3.0. The bolded versions with an asterisk (*) are the packages that were updated from PWA Studio 13.2.0.

NOTE:
Your project may not depend on some packages listed in this table.

[UPDATE THIS TABLE WITH THE LATEST VERSIONS OF EACH PACKAGE]

Package	Latest version
babel-preset-peregrine	1.2.3*
create-pwa	2.4.5
experience-platform-connector	1.0.5
upward-security-headers	1.0.14
venia-sample-backends	0.0.10
venia-sample-eventing	0.0.6
venia-sample-language-packs	0.0.14
venia-sample-payments-checkmo	0.0.12
pagebuilder	8.2.1*
peregrine	13.2.1*
pwa-buildpack	11.4.3*
pwa-theme-venia	1.4.0
upward-js	5.3.2
upward-spec	5.2.1
venia-concept	13.3.0*
venia-ui	10.3.0*
magento2-pwa	0.6.1*
magento2-pwa-commerce	0.0.3
magento-venia-sample-data-modules	0.0.4
magento-venia-sample-data-modules-ee	0.0.3
magento2-upward-connector	2.0.3*
upward-php	2.0.2

13.2.0

PWA Studio Release 13.2.0

NOTE:
This changelog only contains release notes for PWA Studio and Venia 13.2.0
For older release notes, see PWA Studio releases.

Highlights

The 13.2.0 release of PWA Studio provides customers with many accessibility improvements for keyboard and screen-reader access, as well as several bug fixes. Full details are described below.

Accessibility Updates

• Story: 4092 — Sign in > Forget password is working with keyboard Enter key press.
• Story: 4100 — Minicart > Buttons is working with keyboard Enter key press.
• Story: 4120 — Apply Gift Card > Button is working with keyboard Enter key.
• Story: 4112 — Enter Coupon Code > Button is working with keyboard Enter key press.
• Story: 4094 — Apply Gift Card > Link Check Balance button is working now with Enter key press.
• Story: 4111 — Estimate your Shipping > Button is working with keyboard Enter key press.
• bug: 4104 — The screen reader now reads the appropriate message as expected when a shopper clicks Return to apply a gift card on the cart page without entering a gift card number.
• bug: 4104 — System was getting crashed with unexpected error when pressed Retrun button with invalid Gift card number but now fixed and working without any issue.

Additional fixes

• Story: 4086 — Updated to latest @adobe/magento-storefront-event-collector.
• Story: 4040 — Added Dev Container config to improve developer experience.
• Story: 4103 — Updated eventing system to stay compatible with latest AEP schema.
• Bug: 4123 — Edited the Magento2 Backend URL to working url.
• Bug: 4121 — The 'signout' event is now captured.
• Bug: 4118 — PWA Scaffolding Tool uses old version.
• Bug: 4084 — useLink operations empty object destructuring.
• Bug: 4115 — Selecting payment method causing graphql error.
• Bug: 4083 — No results when filtering a category with a composite attribute from layered navigation.
• Bug: 4075 — Venia header/layout broken in offline mode.
• Bug: 4124 — Region required validation is working in pwa according to option selected in Magento.
• Bug: 4109 — Url Rewrite to external URL does not work on PWA.
• Bug: 4114 — PWA shows 404 when having store code in URL.
• Bug: 4102 — When you click on Thumbnail, Add to cart works.
• Bug: 4060 — Search auto populate results not accessible with tab or up/down keys.

13.2.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 13.2.0 release of these pages on desktop and mobile devices.

Desktop scores

	Home Page	Product Category	Product Details	Search Results
Desktop
Performance
Accessibility
Best Practices
SEO
PWA

Mobile scores

	Home Page	Product Category	Product Details	Search Results
Mobile
Performance
Accessibility
Best Practices
SEO
PWA

Known issue

When a user logs out, that user's local storage session persists. As a result, the cart ID from the logged out user is retrieved and given to the guest user on the computer. This causes the following error when the guest user tries to check out: An error has occurred. Please check the input and try again. To resolve this issue, try disabling graphql session sharing as described in the GraphQL documentation on session cookies here: https://devdocs.magento.com/guides/v2.4/graphql/authorization-tokens.html#session-cookies.

Upgrading from a previous version

Use the steps outlined in this section to update your scaffolded project from 13.1.0 to 13.2.0.
See Upgrading versions for more information about upgrading between PWA Studio versions.

Updated package dependencies

Open your package.json file and update the PWA Studio package dependencies to the versions associated with this release.
The following table lists the latest versions of each package as of 13.2.0. The bolded versions with an asterisk (*) are the packages that were updated from PWA Studio 13.1.0.

NOTE:
Your project may not depend on some packages listed in this table.

[UPDATE THIS TABLE WITH THE LATEST VERSIONS OF EACH PACKAGE]

Package	Latest version
babel-preset-peregrine	1.2.2
create-pwa	2.4.5*
experience-platform-connector	1.0.5*
upward-security-headers	1.0.14*
venia-sample-backends	0.0.10
venia-sample-eventing	0.0.6*
venia-sample-language-packs	0.0.14*
venia-sample-payments-checkmo	0.0.12*
pagebuilder	8.2.0*
peregrine	13.1.1*
pwa-buildpack	11.4.2
pwa-theme-venia	1.4.0
upward-js	5.3.2
upward-spec	5.2.1
venia-concept	13.2.0*
venia-ui	10.2.0*
magento2-pwa	0.5.1
magento2-pwa-commerce	0.0.3
magento-venia-sample-data-modules	0.0.4
magento-venia-sample-data-modules-ee	0.0.3
magento2-upward-connector	2.0.2
upward-php	2.0.2

13.1.0

PWA Studio Release 13.1.0

NOTE:
This changelog only contains release notes for PWA Studio and Venia 13.1.0
For older release notes, see PWA Studio releases.

Highlights

• PHP 8.2 support — PWA Studio now supports PHP 8.2. GitHub PRs: 4, 25, 34, 5, 20, 10
• Payment method persists — The chosen payment method now persists throughout the user's session. GitHub PR: 3969
• Node 18 support — PWA Studio now supports Node 18.0,0+. GitHub PR: 172

Additional fixes

• Story: 36 — Updated Zend libraries to respective laminas.
• Bug: 4028 — Fixed support for Page Builder column-line content type
• Bug: 35 — Fixed an issue that crashed the Categories page when applying a filter.
• Bug: 4053 — Fixed an issue that prevented a filter from being applied to the text label.
• Bug: 4059 — Fixed an issue where the URL was not updated properly in Page Builder.
• Bug: 4061 — Fixed null-network requests that occurred when refreshing the Venia home page.
• Bug: 4066 — Fixed fashion-size value to be read by screen readers.
• Bug: 4049 —Fixed keyboard access for the Cancel button adjacent to the Create Account button.
• Bug: 4064 — Fixed keyboard access to the Sign in button.
• Bug: 26 — Fixed Venia sample data cloud deployment with PHP 8.2.
• Bug: 4052 — Fixed an issue that caused the Additional Giftcard link to appear in the discounted section.

13.1.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 13.1.0 release of these pages on desktop and mobile devices.

Desktop scores

	Home Page	Product Category	Product Details	Search Results
Desktop
Performance
Accessibility
Best Practices
SEO
PWA

Mobile scores

	Home Page	Product Category	Product Details	Search Results
Mobile
Performance
Accessibility
Best Practices
SEO
PWA

Known issues

• Event data is currently not being stored properly in the database. Our initial investigation concluded that this would affect all PWA Studio customers using Beacon eventing.

• When a user logs out, that user's local storage session persists. As a result, the cart ID from the logged out user is retrieved and given to the guest user on the computer. This causes the following error when the guest user tries to check out: An error has occurred. Please check the input and try again. To resolve this issue, try disabling graphql session sharing as described in the GraphQL documentation on session cookies here: https://devdocs.magento.com/guides/v2.4/graphql/authorization-tokens.html#session-cookies.

Upgrading from a previous version

Use the steps outlined in this section to update your scaffolded project from 13.0.0 to 13.1.0.
See Upgrading versions for more information about upgrading between PWA Studio versions.

Updated package dependencies

Open your package.json file and update the PWA Studio package dependencies to the versions associated with this release.
The following table lists the latest versions of each package as of 13.1.0. The bolded versions with an asterisk (*) are the packages that were updated from PWA Studio 13.0.0.

Note:
Your project may not depend on some packages listed in this table.

Package	Latest version
babel-preset-peregrine	1.2.2
create-pwa	2.3.5*
experience-platform-connector	1.0.4*
upward-security-headers	1.0.13*
venia-sample-backends	0.0.9
venia-sample-eventing	0.0.5*
venia-sample-language-packs	0.0.13*
venia-sample-payments-checkmo	0.0.11*
pagebuilder	8.1.0*
peregrine	13.0.1*
pwa-buildpack	11.4.1
pwa-theme-venia	1.4.0
upward-js	5.3.2
upward-spec	5.2.1
venia-concept	13.1.0*
venia-ui	10.1.0*
magento2-pwa	0.5.0*
magento2-pwa-commerce	0.0.3*
magento-venia-sample-data-modules	0.0.4*
magento-venia-sample-data-modules-ee	0.0.3*
magento2-upward-connector	2.0.2*
upward-php	2.0.2*

13.0.0

PWA Studio Release 13.0.0

NOTE:
This changelog only contains release notes for PWA Studio and Venia 13.0.0.
For older release notes, see PWA Studio releases.

Highlights

The 13.0 release of PWA Studio provides customers with many accessibility improvements for keyboard and screen-reader access, as well as several bug fixes. Full details are described below.

Accessibility Updates

• Story: 3865 — Venia's main menu and modals now prevent the background page from scrolling.
• Story: 3952 — Added visible text labels to all Venia buttons.
• Story: 3944 — Added alt text to images and removed screen reader access to hidden content on the Order History page.
• Story: 3971 — Added visual indication to show when page content has been refreshed.
• Story: 3977 — Added expanded and collapsed states for the Accordion control.
• Story: 3932 — Matched the accessible name of buttons to their visible text labels.
• Story: 3973 — Enabled keyboard navigation on the Cart page.
• Story: 3980 — Enabled keyboard navigation on the Checkout page.
• Story: 3961 — Labeled required form fields as required.
• Story: 3978 — Enabled keyboard navigation on Sign In and Create Account pages.
• Story: 3988 — Added Accessible names to all icon buttons.
• Story: 3979 — Enabled keyboard navigation on Checkout page.
• Story: 3962 — Added visual indications of focus state on buttons.
• Story: 3931 — Added page title to the Search page for screen readers.
• Story: 4006 — Added additional documentation and video links to the README for magento/pwa-studio.

Bug fixes

• Bug: 31 — Fixed the issue where the setup:upgrade command got stuck at the Magento_PageBuilderPwa step when PageBuilder contained 20+ MB of assets.
• Bug: 3982 — Replaced id with uid in noProductsFound.js to give a unique value for each category and resolve the browser console warning.
• Bug: 4001 — Fixed the redirection URL for the Add to Cart button on a configurable product gallery item to match the URL used on the product tile.
• Bug: 3874 — Fixed all hooks and talons to use named exports to prevent errors when using them for wrapping.
• Bug: 4011 — Fixed tabIndex prop type on categoryBranch, categoryLeaf, and categoryTree.
• Bug: 4011 — Fixed accessibility issue on home page with carousel gallery item links by adding aria-label for link names.
• Bug: 4019 — Fixed an issue in which the addToCart event would crash the app when contexts were not set.
• Bug: [4025][] — Fixed productPageView event to capture and add more data when setting the productPageView context.

13.0.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 13.0.0 release of these pages on desktop and mobile devices.

Desktop scores

	Home Page	Product Category	Product Details	Search Results
Desktop
Performance
Accessibility
Best Practices
SEO
PWA

Mobile scores

	Home Page	Product Category	Product Details	Search Results
Mobile
Performance
Accessibility
Best Practices
SEO
PWA

Known issue

When a user logs out, that user's local storage session persists. As a result, the cart ID from the logged out user is retrieved and given to the guest user on the computer. This causes the following error when the guest user tries to check out: An error has occurred. Please check the input and try again. To resolve this issue, try disabling graphql session sharing as described in the GraphQL documentation on session cookies here: https://devdocs.magento.com/guides/v2.4/graphql/authorization-tokens.html#session-cookies.

Upgrading from a previous version

Use the steps outlined in this section to update your scaffolded project from 12.7.0 to 13.0.0.
See Upgrading versions for more information about upgrading between PWA Studio versions.

Updated package dependencies

Open your package.json file and update the PWA Studio package dependencies to the versions associated with this release.
The following table lists the latest versions of each package as of 13.0.0. The bolded versions with an asterisk (*) are the packages that were updated from PWA Studio 12.7.0.

Note:
Your project may not depend on some packages listed in this table.

Package	Latest version
babel-preset-peregrine	1.2.2
create-pwa	2.3.4*
experience-platform-connector	1.0.3*
upward-security-headers	1.0.12*
venia-sample-backends	0.0.9
venia-sample-eventing	0.0.4*
venia-sample-language-packs	0.0.12*
venia-sample-payments-checkmo	0.0.10*
pagebuilder	8.0.0*
peregrine	13.0.0*
pwa-buildpack	11.4.1
pwa-theme-venia	1.4.0
upward-js	5.3.2
upward-spec	5.3.1
venia-concept	13.0.0*
venia-ui	10.0.0*
magento2-pwa	0.3.0
magento2-pwa-commerce	0.0.2
magento-venia-sample-data-modules	0.0.3
magento-venia-sample-data-modules-ee	0.0.2
magento2-upward-connector	2.0.1
upward-php	2.0.1

12.7.0

PWA Studio Release 12.7.0

NOTE:
This changelog only contains release notes for PWA Studio and Venia 12.7.0.
For older release notes, see PWA Studio releases.

Highlights

The 12.7.0 release of PWA Studio provides customers with a better product selection experience by showing which variations of a configurable product are out of stock. This addition prevents customers from selecting out of stock variations when configuring a product for purchase.

This release also adds and improves several keyboard and screen-reader accessibility features along with user session and permission bug fixes. Full details are described below.

New Features

• Out-of-stock for product variations 3903 — The out-of-stock setting can now be applied to configurable product variations, making it easier for customers to configure a product with the available variations.
• Tailwind theming documentation 155 — New instructions on how to install, configure, and use Tailwind with Venia to theme your own PWA Studio app. See Tailwind Theming for PWA Studio apps.
• Accessible Action menus 3791 — Action menu functions are now accessible by keyboard.
• Accessible Search results content 3891 —Screen reading of search results has been improved.
• Accessible Search results count 3935 — Screen reader announces the total items found in the searched result.
• Accessible UI Control states 3792 — Screen readers now announce the expanded and collapsed states of controls.
• Accessible Mega Menu 3798 — The Mega Menu is now accessible by keyboard.
• Accessible Actionable UI elements 3864 — When actionable UI elements receive focus, a visible focus indicator is present.
• Accessible Logo component 3936 — The Logo component now renders the alt property.

Bug Fixes

• Fixed selected payment method 3969 — The selected payment method now persists during the user session, when multiple payment methods are available.
• Fixed permission error 3955 — Fixed a permission error that occurred during the compilation process initiated by Docker.
• Fixed import typo 3648 — Fixed a typo for the import name of a component.
• Fixed console warnings 3942 — Fixed console warnings for invalid DOM property names.

12.7.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 12.7.0 release of these pages on desktop and mobile devices.

Desktop scores

	Home Page	Product Category	Product Details	Search Results
Desktop
Performance
Accessibility
Best Practices
SEO
PWA

Mobile scores

	Home Page	Product Category	Product Details	Search Results
Mobile
Performance
Accessibility
Best Practices
SEO
PWA

Known issue

When a user logs out, that user's local storage session persists. As a result, the cart ID from the logged out user is retrieved and given to the guest user on the computer. This causes the following error when the guest user tries to check out: An error has occurred. Please check the input and try again. To resolve this issue, try disabling graphql session sharing as described in the GraphQL documentation on session cookies here: https://devdocs.magento.com/guides/v2.4/graphql/authorization-tokens.html#session-cookies.

Upgrading from a previous version

Use the steps outlined in this section to update your scaffolded project from 12.6.0 to 12.7.0.
See Upgrading versions for more information about upgrading between PWA Studio versions.

Updated package dependencies

Open your package.json file and update the PWA Studio package dependencies to the versions associated with this release.
The following table lists the latest versions of each package as of 12.7.0. The bolded versions with an asterisk (*) are the packages that were updated from PWA Studio 12.6.0.

Note:
Your project may not depend on some packages listed in this table.

Package	Latest version
babel-preset-peregrine	1.2.2*
create-pwa	2.3.3*
experience-platform-connector	1.0.2*
upward-security-headers	1.0.11*
venia-sample-backends	0.0.9*
venia-sample-eventing	0.0.3*
venia-sample-language-packs	0.0.11*
venia-sample-payments-checkmo	0.0.9*
pagebuilder	7.4.2*
peregrine	12.6.0*
pwa-buildpack	11.4.1*
pwa-theme-venia	1.4.0*
upward-js	5.3.2
upward-spec	5.2.1
venia-concept	12.7.0*
venia-ui	9.7.0*
magento2-pwa	0.3.0
magento2-pwa-commerce	0.0.2
magento-venia-sample-data-modules	0.0.3
magento-venia-sample-data-modules-ee	0.0.2
magento2-upward-connector	2.0.1
upward-php	2.0.1

12.6.0

PWA Studio Release 12.6.0

NOTE:
This changelog only contains release notes for PWA Studio and Venia 12.6.0.
For older release notes, see PWA Studio releases.

Highlights

The 12.6.0 release of PWA Studio focuses on accessibility improvements and bug fixes.

• Accessibility Improvements: Added autocomplete attributes to checkout shipping and payment forms — 3785
• Accessibility Improvements:: Open panels now have keyboard focus. — 3805
• Accessibility Improvements:: Navigation buttons for carousels now meet contrast requirements. — 3787
• Controls now have a descriptive accessible name. Visible [label] elements are correctly associated with their inputs using the "for" attribute. — 3786
• Removes duplicate logic from QuoteGraphQlPwa module — 29
• Bug Fix: Failing cypress tests fixed — 3911
• Bug Fix - Braintree payment form Customer Name field values now appear normal. — 3912
• Bug Fix: Braintree npm package braintree-web-drop-in updated to latest version to fix csp related console errors. — 3912
• Accessibility Improvements: Keyboard focus no longer lands on hidden elements in Kebab menu — 3800
• Fixed a bug in mobile view where the Edit and Remove options in the kebab menu for a cart item on the cart page is non functional. - 3925
• Fixed a console error when accessing different filters. - 30

12.6.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 12.6.0 release of these pages on desktop and mobile devices.

Desktop scores

	Home Page	Product Category	Product Details	Search Results
Desktop
Performance
Accessibility
Best Practices
SEO
PWA

Mobile scores

	Home Page	Product Category	Product Details	Search Results
Mobile
Performance
Accessibility
Best Practices
SEO
PWA

Upgrading from a previous version

Use the steps outlined in this section to update your scaffolded project from 12.5.0 to 12.6.0.
See Upgrading versions for more information about upgrading between PWA Studio versions.

Update dependencies

Open your package.json file and update the PWA Studio package dependencies to the versions associated with this release.
The following table lists the latest versions of each package as of 12.6.0.

Note:
Your project may not depend on some packages listed in this table.

Package	Latest version
babel-preset-peregrine	1.2.1
create-pwa	2.3.2
experience-platform-connector	1.0.1
upward-security-headers	1.0.10
venia-sample-backends	0.0.8
venia-sample-eventing	0.0.2
venia-sample-language-packs	0.0.10
venia-sample-payments-checkmo	0.0.8
pagebuilder	7.4.1
peregrine	12.5.1
pwa-buildpack	11.4.0
pwa-theme-venia	1.3.0
upward-js	5.3.2
upward-spec	5.2.1
venia-concept	12.6.0
venia-ui	9.6.0
magento2-pwa	0.3.0
magento2-pwa-commerce	0.0.2
magento-venia-sample-data-modules	0.0.3
magento-venia-sample-data-modules-ee	0.0.2
magento2-upward-connector	2.0.1
upward-php	2.0.1

12.5.0

PWA Studio Release 12.5.0

NOTE:
This changelog only contains release notes for PWA Studio and Venia 12.5.0.
For older release notes, see [PWA Studio releases][].

Highlights

The 12.5.0 release of PWA Studio focuses on 2 areas:

• A new eventing framework
• Accessibility improvements

Eventing

The main feature introduced in PWA Studio 12.5 is the eventing framework.

This framework lets developers write code that subscribes to event data published by the application.
This data can be sent to different analytics services, such as the Adobe Experience Platform.

The framework also provides an API that lets extension developers send out events in their own components.
A sample extension is included in this release to serve as a starting point or tutorial for developers.

This release also include the Experience Platform Connector, a PWA Studio extension that can be installed into a storefront project.
This extension leverages the eventing framework to collect and send data to the Adobe Experience Platform.

The core events published by the framework include:

• Cart operations
• Mini cart views
• Page views
• Product impressions and clicks
• Search requests
• User account actions

Accessibility

We have made numerous improvements around accessibility in the Venia template project. Most of these changes are around ensuring proper text and button contrast and ensuring that screen readers are getting proper information from the application.

Other highlights and fixes

• We now ensure that custom controls provide accessible names and indicate their expanded or collapsed state. — [3857][]
• Screen readers are now informed when a new page view loads. — [3858][]
• Increased contrast on the custom blue focus indicator. — [3858][]
• Fixed gray text in Venia that did not have sufficient contrast. — [3858][]
• Visual indicators of state now provide a proper contrast ratio of at least 3:1 against the background color. — [3857][]
• Checkout payment buttons and text now have proper contrast ratios. — [3857][]
• The shopping cart button now properly reports its state to screen readers. — [3858][]
• Apollo links can now be customized by a `configureLinks` prop to `Adapter / useAdapter`. Apollo code has been extracted to its own module. — [3842][]
• Added dispatcher for search requests. — [3844][]
• Removed venia-adobe-data-layer extension as its functionality is incorporated into the Magento Storefront Events SDK. — [3863][]
• Fixed issue where focusing on an image in Venia would cause screen readers to say "Venia Venia". Now it only says it once. — [3858][]
• Fixed the Mega menu accidentally closing while accessing secondary menus. — [3850][]

12.5.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 12.5.0 release of these pages on desktop and mobile devices.

Desktop scores

	Home Page	Product Category	Product Details	Search Results
Desktop
Performance
Accessibility
Best Practices
SEO
PWA

Mobile scores

	Home Page	Product Category	Product Details	Search Results
Mobile
Performance
Accessibility
Best Practices
SEO
PWA

Type	Description	GitHub PR
Story	Eventing Framework	[3773][]
Story	Track Mini Cart Views	[3843][]
Story	5 Track Checkout	[3870][]
Story	Track user account actions	[3855][]
Story	[Issue] AC-2785::Custom dropdown controls lack appropriate name and state inf…	[3857][]
Story	[Group 2][Issue] AC-2482::Screen readers not informed when new page view loads. (patte…	[3858][]
Story	[Group 2][Issue] AC-2483::Contrast insufficient - custom blue focus indicator	[3858][]
Story	[Group 2][Issue] AC-2486::contrast insufficient - medium grey text (Search Results)	[3858][]
Story	[Issue] AC-2490::Contrast insufficient - product image selected state indicat…	[3857][]
Story	[Issue] AC-2496::Contrast insufficient - light grey text (Checkout - Payment)	[3857][]
Story	[Group 2][Issue] AC-2786::Shopping bag button does not programmatically communicate st…	[3858][]
Story	Experience Platform Connector extension	[3885][]
Story	[Issue] Make Apollo links customizable	[3842][]
Story	Track Page Views	[3856][]
Story	Track Search Requests	[3844][]
Story	Track Cart operations	[3860][]
Story	Deprecate / Remove the Venia Adobe Data Layer extension	[3863][]
Story	Reduce docker build context size	[3845][]
Story	Track product impressions and clicks	[3859][]
Bug	[Group 2][Issue] BUG#AC-2499::When focusing on 'Venia' image while using screen reader…	[3858][]
Bug	[bug]: Mega menu collapses when trying to select sub-category on 12.4	[3850][]

Documentation updates

• eventing overview
• Event API
• Custom Events
• Subscribing to events
• Adobe Experience Platform

Upgrading from a previous version

Use the steps outlined in this section to update your scaffolded project from 12.4.0 to 12.5.0.
See Upgrading versions for more information about upgrading between PWA Studio versions.

Update dependencies

Open your package.json file and update the PWA Studio package dependencies to the versions associated with this release.
The following table lists the latest versions of each package as of 12.5.0.

Note:
Your project may not depend on some packages listed in this table.

Package	Latest version
babel-preset-peregrine	1.2.1
create-pwa	2.3.1
experience-platform-connector	1.0.0
upward-security-headers	1.0.9
venia-sample-backends	0.0.8
venia-sample-eventing	0.0.1
venia-sample-language-packs	0.0.8
`venia-sample-pa...

12.4.0

PWA Studio Release 12.4.0

NOTE:
This changelog only contains release notes for PWA Studio and Venia 12.4.0
For older release notes, see [PWA Studio releases][].

Highlights

The main focus of PWA Studio 12.4 is additional support for working with both system attributes and custom product attributes. While previously, this could be done, results were difficult to parse, with little ability for sorting and filtering. Now, system and custom product attributes are returned in their own object within the GraphQL response, which can be sorted and filtered.

Product attributes

• Products can now be sorted by the product attribute value on the product listing page. — [3761][]
• The Venia sample data has been updated to include product attributes. — [23][]
• Product attribute values can now be used to search for products. — [3747][]

Product Attributes on PDP

• The product detail page has dedicated slots for rendering product attributes values.
• The product detail page supports all content layout options available with Page Builder (full-width, full-bleed, contained).

Other highlights and fixes

• It is now possible to build a project using an older version of PWA studio by appending the version number to the `create` command.
• Updated the Tailwind preset file in the Venia theme package to extend the base Tailwind configuration and add Venia-specific custom values. - [3686][]
• PWA Studio now supports CSS breakpoints set within PageBuilder components. — [3673][]
• The ProductQuantity component has been removed from the codebase as it is not used anymore. It has been replaced with the QuantityStepper component. — [3717][]
• Cypress tests have been added to check for offline mode on the Home, Category, Product, and Search pages. — [3710][]
• Magento Community Edition (CE) has been rebranded as "Magento Open Source" and the Enterprise Edition (EE) is now "Adobe Commerce". — [3697][]
• Currency is now set properly when changing the currency in a PageBuilder product collection. Previously, when changing currency from the header dropdown, prices in PageBuilder product collections were not getting updated. — [3720][]
• Video background with parallax enabled on Safari browser should now behave as intended. — [3661][]
• Restored TTL support in BrowserPersistence. — [3729][]
• Resolved static build failure issues for venia-sample-data-modules repository. — [21][]
• The `product_url_suffix` value is now properly passed. Previously, it would return `null`. — [3666][]
• Fixed a bug that would throw a Javascript error when clicking on a configurable product where an option has been disabled on the backend. — [3740][]
• Replaced existing CSS values in UI components with equivalent Tailwind classes. - [3686][]

12.4.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 12.4.0 release of these pages on desktop and mobile devices.

	Home Page	Product Category	Product Details	Search Results
Venia Pages
Desktop Performance
Mobile Performance
Accessibility (same for both)
Best Practices (same for both)
SEO (same for both)
PWA

Type	Description	GitHub PR
Story	Add PageBuilder media query breakpoints support in PWA	[3673][]
Story	Make QuantityStepper @api and deprecate ProductQuantity	[3717][]
Story	[Cypress] Add tests for offline mode	[3710][]
Story	Update the Sample data with Product Attributes	[23][]
Story	Support new branding terms	[3697][]
Story	Filtering Product by the attribute value	[3747][]
Story	View Product Attributes values on PDP - Text input, Multi-select, Boolean, Date	[3761][]
Bug	[bug]: Page builder product collection's price+currency is not updating on currency changes.	[3720][]
Bug	upward-php latest develop not compatible with php 7.4 on cloud pro.	[8][]
Bug	[PB] Parallax video background is broken on Safari	[3661][]
Bug	Regression fix disabled TTL support in BrowserPersistence	[3729][]
Bug	Static build failures in magento-commerce/venia-sample-data-modules repo	[21][]
Bug	[bug]: product_url_suffix cloud be return as null from backend	[3666][]
Bug	Disabled product throw an exception cannot read properties of undefined	[3740][]
Bug	Deprecated field which could return incorrect discounted price is no longer returned	[3760][]
Bug	On mobile, the short description is now properly displayed below the image, rather than above.	[3808][]
Bug	A product with a discounted price now shows that price in the catalog, rather than the original price.	[24][]

Documentation updates

• Updated the GraphQL guide with latest changes to the magneto2-pwa module.
• Added instructions on how to build scaffolding with a specific version of PWA Studio.
• Added information about the PWA Studio UI Kit for Adobe XD

Upgrading from a previous version

Use the steps outlined in this section to update your scaffolded project from 12.3.0 to 12.4.0.
See Upgrading versions for more information about upgrading between PWA Studio versions.

Update dependencies

Open your package.json file and update the PWA Studio package dependencies to the versions associated with this release.
The following table lists the latest versions of each package as of 12.4.0.

Note:
Your project may not depend on some of the packages listed in this table.

Package	Latest version
babel-preset-peregrine	1.2.1
create-pwa	2.3.0
upward-security-headers	1.0.8
venia-adobe-data-layer	1.0.5
venia-sample-backends	0.0.7
venia-sample-language-packs	0.0.8
venia-sample-payments-checkmo	0.0.6
pagebuilder	7.3.0
peregrine	12.4.0
pwa-buildpack	11.3.0
pwa-theme-venia	1.3.0
upward-js	5.3.1
upward-spec	5.2.1
venia-concept	12.4.0
venia-ui	9.4.0
magento2-pwa	0.2.1
magento2-pwa-commerce	0.0.2
magento-venia-sample-data-modules	0.0.3
magento-venia-sample-data-modules-ee	0.0.2
magento2-upward-connector	2.0.1
upward-php	2.0.1

12.3.0

PWA Studio Release 12.3.0

NOTE:
This changelog contains release notes for PWA Studio and Venia 12.3.0
For older release notes, see [PWA Studio releases][].

12.3.0 Highlights

Personalized content support

• Added shimmer loaders for Dynamic blocks to avoid layout shift. Shimmer loaders are only rendered if minHeight is specified on the Row containing the Dynamic block. This implementation gives you a choice: You can set the Row's minHeight to render the shimmer or remove the minHeight to remove the shimmer. For Dynamic blocks that rarely render, we recommend removing the minHeight property from the Rows containing those Dynamic blocks. — [3713][]
• Added the new PersonalizedContentSampleDataVenia module that contains customer segments, dynamic blocks, and cart rule promotion sample data for personalized content. — [19][],[2][],[3670][]
• Shopping cart promotions are now properly displayed depending on customer segment. — [3609][]
• You can now make GraphQL queries for dynamic blocks. — [3587][],[2][]

ReCaptcha support

• You can now use ReCaptcha V3 on the Braintree payment form and the Place Order form. — [3691][],[24][]
• reCAPTCHA V3 validation is now available on the following customer forms:
  • Customer Login
  • Customer account creation
  • Customer information change (password) — [3702][]
  • Forgot Password form. — [3604][],[12][],[20][]

PageBuilder content optimization

• Shimmers are now loaded when rendering a Page Builder CMS page. This helps reduce CLS and increase load speed. — [3711][]
• Images from Page Builder content now include height and width dimensions. This helps reduce CLS when rendering the images. — [3712][]
• Store-view specific label and localization support has been added for product attributes. — [17][]
• PWA Studio can now retrieve image metadata from Page Builder. — [16][],[17][]

Other highlights

• In the Link component, prefetchType property has been renamed to shouldPrefetch. This helps to clarify that it is a boolean, rather a property that returns a type. prefetchType is deprecated but not removed. — [3646][]
• Refactored the reCaptcha to ensure it is backwards compatible with 12.2.0. — [3696][]
• The "Sign In" link has been removed from the 2nd stage of checkout. This ensures the cart configuration (guest or account holder) does not change in the middle of checkout. — [3672][]
• Dependency packages have been updated. See #3611 for more details about specific package versions. — [3611][]
• Reporting has been improved when running Cypress tests on a headless instance. — [3613][]
• Adobe Commerce users can now set gift options on the Order level. — [3540][]
• Long Wish List names no longer break the layout or force users to scroll in order to close modal dialogs. — [3706][]
• Products with configurable product variants are now properly added to Wish Lists. Previously, adding a configurable product threw an error. — [3703][]
• The virtual products extension has been removed. — [3612][]
• To increase performance, instances of the useMemo type have been changed to const in the productUrlSuffix talon. — [3660][]
• Added support that makes it easier to click-select tabs when they are displayed in a long list of Tab Items from Page Builder. — [3676][]

12.3.0 Lighthouse scores

With each new release of PWA Studio, we perform Lighthouse audits of four Venia page types, each representing a different level of complexity. Shown below are the Lighthouse scores for the 12.3.0 release of these pages on desktop and mobile devices.

	Home Page	Product Category	Product Details	Search Results
Venia Pages
Desktop Performance
Mobile Performance
Accessibility (same for both)
Best Practices (same for both)
SEO (same for both)
PWA

Stories and bug fixes

Type	Description	GitHub PR
Story	Shimmer Loader for Dynamic Blocks	[3713][]
Story	Query for available Dynamic Blocks	[3587][], [2][]
Story	CMS Page Shimmer Loader	[3711][]
Story	Update the Sample Data with Personalized content	[19][], [2][], [3670][]
Story	reFactored reCAPTCHA	[3696][]
Story	Add reCaptcha to the Checkout Forms	[3691][], [24][]
Story	Add reCaptcha to the Account Information Forms	[3702][]
Story	Add reCaptcha to the Forgot Password Form	[3604][], [12][], [20][]
Story	Rename Link's prefetchType prop	[3646][]
Story	Store view specific label/localization support for product attributes	[17][]
Story	Update Magento capability table	[3724][]
Story	Remove Sign-In link on 2nd step of checkout	[3672][]
Story	Images to include dimensions	[3703][]
Story	Validate Shopping Cart Promotions are displayed correctly	[3609][]
Story	Configurable images are not shown in Edit Cart Item menu	[3695][]
Story	Backend PageBuilder image metadata support	[16][], [17][]
Story	Update packages and dependencies	[3611][]
Story	Add cypress status reporting while running headless	[3613][]
Bug	Gift options on Order Level (Commerce only)	[3540][]
Bug	Parent product image thumbnail has been shown in mini cart instead of product itself	[3690][]
Bug	Long wishlist name length breaks layout	[3706][]
Bug	Change default sort order on Search page to 'Best Match'	[3698][] ...