Magento Open Source 2.1 Release Candidate 2 (RC2) Release Notes

We are pleased to present Magento 2.1 Release Candidate 2 (RC2). This release candidate build is not intended for production purposes. Instead, it provides the development community opportunities to:

  • preview the new features and fixes that Magento 2.1 GA will contain

  • contribute to the Magento 2.1 code base by identifying unresolved issues

  • test your 2.0 extensions against 2.1

We welcome your participation in this process! Please open any Open Source issues or Pull Requests on the Open Source GitHub repository. For more information on how to provide feedback and contribute on GitHub, see Code contributions.

Backward-incompatible changes are documented in Magento 2.1 Backward Incompatible Changes.


Magento Open Source (formerly Community Edition) 2.1 includes several new and exciting features:

  • PayPal enhancements include PayPal in-context checkout and saved credit cards. In-context checkout helps to increase conversion rates 69 bps by allowing shoppers to pay with PayPal without leaving the merchant’s site. PayPal saved credit cards boost repeat purchases by allowing merchants to securely store credit card information with PayPal so customers do not need to re-enter it in checkout or when reordering items from the Admin interface.

  • Braintree enhancements enable merchants to qualify for the simplest set of PCI compliance requirements by using Braintree Hosted Fields to collect all sensitive cardholder information in checkout. Merchants retain complete control over their checkout style and layout because Braintree uses small, transparent iframes to replace individual payment fields. Merchants can now also access Braintree settlement reports from within the Magento Admin interface.

  • Improved management interfaces make it faster and easier to search for information in the Admin, set up global search synonyms, and create new product, category, and CMS content.

Known issues

Magento Open Source 2.1, Release Candidate 2 includes the following known issues:

  • Magento does not apply the Cart Price or Catalog Price sales rules accordingly to the store website’s timezone, as expected.
  • You cannot update from Magento 2.0.x to Magento 2.1.x with Sample Data.

Fixed issues


  • Several address-related issues associated with Checkout have been resolved.
  • Customers with an existing saved address can now add a new address during checkout.
  • Clicking the Reorder button now loads products as expected when persistent shopping cart is enabled.
  • The Go to Checkout button now works as expected. Previously, when you clicked the Go to Checkout button, Magento would display a login pop-up window.
  • Checkout now works as expected when purchasing products during a persisted session.

Bundle products

  • The Add Products to Option button now works as expected when you create a new update for a Bundle product.
  • Quotation marks can now be included in Bundle product names. (GITHUB-4414)


  • Reflected cross-site scripting (XSS) can no longer occur through the Authorizenet module’s redirect data.
  • Admin User sessions no longer expire prematurely in installations running Redis for session storage. Previously, you were directed back to the login page after logging in to the Admin panel, waiting a short period time (less than the Admin Session Lifetime value), and trying to navigate to the Dashboard.
  • Magento now returns available services in WSDL schema. Previously, you could not process SOAP requests as expected.
  • Fatal errors no longer occur when running CLI commands after compilation in some regression environments.
  • You can now save a product after applying an update for it.
  • Newly created categories now appear as expected on the Navigation menu.
  • Magento no longer references empty targets in other targets.
  • You can now run all integration tests in developer mode.
  • Category pages now display swatches of configurable products based on color swatch attribute.
  • Magento now successfully saves future special dates in the Advanced Price page.
  • You can now filter entries in the Product Reviews report by date.
  • Catalog Price Rules are now applied as expected, depending upon the time frame stated in the Price Rule.
  • The permissions set for a category are now applied as expected.
  • After you install and enable a module, the System > Extensions > Integrations page lists the new Integration generated by the module. (GITHUB-4023)
  • Phrases with escaped slash characters are now translated. Previously, if a phrase were wrapped with single quotes, Magento would not display it correctly.
  • Downloadable products are no longer shown as out of stock on the Category page.
  • Changes to Customer group are now immediately applied to logged-in customers.
  • You can now successfully save products with custom options.
  • You can now configure a product whose last attribute has a price of zero, and the correct total price results. (GITHUB-3912)
  • Optional dropdown product attributes can now be left blank.
  • Magento now successfully migrates data when Google Analytics’s “Content Experiments” is enabled.
  • Cart now updates and lists rates for custom shipping methods as expected when you change the shipping address. (GITHUB-4679)
  • You can now view configurable products when using sample data.
  • Layered navigation now includes a list of all product attributes.
  • The collectRates() method now obtains the full address details for a registered customer.
  • The Customer Address tab is populated as expected after you create a new order. Previously, Magento did not list addresses on this tab when you’d create a new order.
  • Logo folders have been added to the list of allowed resources. (GITHUB-4078)
  • The Force Sign-in button now works as expected.
  • Magento no longer makes unexpected calls when you view a product in the storefront.
  • You can now reorder a product with a required custom option (type = file). Previously, if you tried to reorder a product under these conditions, you would encounter an error when opening the shopping cart. (GITHUB-4058)
  • Gift Message information is now present as expected in the extension_attributes when you request this list by Web API. Previously, if you placed an order with a Gift Message, and then performed a Web API request to get the list of orders, Gift Message information would be absent in the extension_attributes. (GITHUB-4309)
  • The getPassword() and getPasswordConfirm() methods now return the password and passwordconfirm parameters as strings. (GITHUB-4355)

Messages and documentation

  • The getList method documentation has been enhanced.
  • Error messages associated with cron processes are now more helpful. (GITHUB-3189)
  • Magento now displays an appropriate message when you add less than the required minimum items in your cart.
  • Message serialization now complies with AMPQ specifications.

Technology stack

Our technology stack is built on PHP and MySQL. Magento 2.1 RC3 supports:

  • PHP 5.6
  • PHP 7.0.2
  • PHP 7.0.6 + up until 7.1
  • MySQL 5.6.

We do not support PHP 5.5.x or 7.0.5.

Installation and upgrade instructions

You can install Magento Open Source 2.1 Release Candidate 1 (RC1) from either Github or by using Composer. This Release Candidate is for test purposes only. Do not install it in a production environment.

See one of the following sections:

Install from GitHub

Before proceeding, please familiarize yourself with these prerequisites, then run

git clone

git checkout tags/2.1.0-rc2 [-b 2.1.0-rc2]

Install using Composer

This Release Candidate is available from Before installing this Release Candidate using Composer, familiarize yourself with the Composer metapackage prerequisites, then run

composer create-project --repository-url= magento/project-community-edition=2.1.0-rc1 <installation directory name>

Upgrade existing installations

This section discusses how to upgrade to a Release Candidate.

Do not upgrade to a Release Candidate on a production system. Upgrade to a Release Candidate on a development system only.

Upgrade an existing installation from the GitHub repository

Developers who contribute to the Open Source codebase can upgrade manually from the Magento Open Source GitHub repository.

  1. Go to the Contributing Developers page.

  2. Follow the instructions to pull the updates from the repository and update using Composer.

Other upgrades

Other types of upgrades are discussed in Upgrade to Magento version 2.1 (June 22, 2016).

Migration toolkits

The Data Migration Tool helps transfer existing Magento 1.x store data to Magento 2.x. This command-line interface includes verification, progress tracking, logging, and testing functions. For installation instructions, see Install the Data Migration Tool. Consider exploring or contributing to the Magento Data Migration repository.