<!DOCTYPE html>
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" lang="en-us" xml:lang="en-us" data-mc-search-type="Stem" data-mc-help-system-file-name="Magento_Open_Source_1.xml" data-mc-path-to-help-system="../" data-mc-has-content-body="True" data-mc-target-type="WebHelp2" data-mc-runtime-file-type="Topic;Default" data-mc-preload-images="false" data-mc-in-preview-mode="false" data-mc-toc-path="Marketing|Promotions|Shopping Cart Price Rules">
<head>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>Buy X Get Y Free</title>
<link rel="shortcut icon" href="http://magento.com/sites/default/files/Magento_Favicon_64x64.ico" type="image/vnd.microsoft.icon" />
<link rel="icon" href="http://magento.com/sites/default/files/Magento_Favicon_64x64.ico" type="image/vnd.microsoft.icon" />
<link href="../Resources/TableStyles/Code.css" rel="stylesheet" />
<link href="../Skins/Default/Stylesheets/Slideshow.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Skins/Default/Stylesheets/TextEffects.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Skins/Default/Stylesheets/Topic.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Skins/Default/Stylesheets/Components/Styles.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Skins/Default/Stylesheets/Components/Tablet.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Skins/Default/Stylesheets/Components/Mobile.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Skins/Fluid/Stylesheets/foundation.5.5.0.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Skins/Fluid/Stylesheets/Styles.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Skins/Fluid/Stylesheets/Tablet.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Skins/Fluid/Stylesheets/Mobile.css" rel="stylesheet" data-mc-generated="True" />
<link href="../Resources/Stylesheets/master2.2.0.css" rel="stylesheet" />
<style>/*<meta />*/
.button.print-button
{
-pie-background: url('../Skins/Default/Stylesheets/Images/printer.png') no-repeat center center, linear-gradient(#ffffff, #ececec);
}
.button.remove-highlight-button
{
-pie-background: url('../Skins/Default/Stylesheets/Images/highlight.png') no-repeat center center, linear-gradient(#ffffff, #ececec);
}
.button.expand-all-button
{
-pie-background: url('../Skins/Default/Stylesheets/Images/expand.png') no-repeat center center, linear-gradient(#ffffff, #ececec);
}
.button.separator-button
{
-pie-background: linear-gradient(#ffffff, #ececec);
}
.button.collapse-all-button
{
-pie-background: url('../Skins/Default/Stylesheets/Images/collapse.png') no-repeat center center, linear-gradient(#ffffff, #ececec);
}
.needs-pie
{
behavior: url('../Resources/Scripts/PIE-no-motw.htc');
}
</style>
<script src="../Resources/Scripts/custom.modernizr.js">
</script>
<script src="../Resources/Scripts/jquery.min.js">
</script>
<script src="../Resources/Scripts/require.min.js">
</script>
<script src="../Resources/Scripts/require.config.js">
</script>
<script src="../Resources/Scripts/foundation.5.5.0_custom.js">
</script>
<script src="../Resources/Scripts/foundation.offcanvas.js">
</script>
<script src="../Resources/Scripts/plugins.min.js">
</script>
<script src="../Resources/Scripts/MadCapAll.js">
</script>
</head>
<body>
<div class="foundation-wrap">
<div class="off-canvas-wrap" data-offcanvas="">
<section class="inner-wrap">
<!-- added from here -->
<nav class="tab-bar" data-mc-ignore="true">
<div class="nav-search row outer-row">
<div class="desktopOnly">
<form class="search" action="#">
<div class="search-bar search-bar-container needs-pie">
<input class="search-field needs-pie" type="search" placeholder="Search" />
<div class="search-filter-wrapper">
<div class="search-filter">
<div class="search-filter-content">
<ul>
<li>All Files</li>
</ul>
</div>
</div>
</div>
<div class="search-submit-wrapper" dir="ltr">
<div class="search-submit" title="Search">
</div>
</div>
</div>
</form>
</div>
</div>
<section class="middle tab-bar-section row outer-row clearfix">
<div class="logoContainer"><a class="logo" href="../getting-started.html" alt="Logo"></a>
</div>
<div class="relative clearfix">
<div class="navigation-wrapper">
<ul class="navigation clearfix">
<li class="has-children"><a href="../getting-started.html">Getting Started</a>
<ul class="sub-menu">
<li><a href="../frontmatter/contents.html">Contents</a>
</li>
<li><a href="../magento/about-this-guide.html">About this Guide</a>
</li>
<li class="has-children"><a href="../introduction.html">Introduction</a>
<ul class="sub-menu">
<li class="has-children"><a href="../getting-started/welcome.html">Welcome to Magento</a>
<ul class="sub-menu">
<li><a href="../getting-started/resources.html">Resources</a>
</li>
<li><a href="../getting-started/magento-social.html">Join the Conversation!</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../magento/about-this-release.html">About This Release</a>
<ul class="sub-menu">
<li><a href="../magento/system-requirements.html">System Requirements</a>
</li>
<li><a href="../magento/magento-install.html">Installing Magento</a>
</li>
<li><a href="../magento/prelaunch-checklist.html">Prelaunch Checklist</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../magento/magento-account.html">Your Magento Account</a>
<ul class="sub-menu">
<li><a href="../magento/magento-account-share.html">Sharing Your Account</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../getting-started/quick-tour.html">Quick Tour</a>
<ul class="sub-menu">
<li><a href="../getting-started/customer-journey.html">Customer Journey</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../basic-configuration.html">Basic Configuration</a>
<ul class="sub-menu">
<li class="has-children"><a href="../store-operations/admin-overview.html">Store Admin</a>
<ul class="sub-menu">
<li><a href="../store-operations/admin-login.html">Admin Login</a>
</li>
<li><a href="../store-operations/admin-messages.html">Message Inbox</a>
</li>
<li><a href="../store-operations/admin-menu.html">Admin Menu</a>
</li>
<li><a href="../store-operations/admin-search-tools.html">Admin Tools</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../store-operations/store-details.html">Store Details</a>
<ul class="sub-menu">
<li><a href="../configuration/store-information.html">Store Information</a>
</li>
<li><a href="../configuration/locale.html">Locale Options</a>
</li>
<li><a href="../configuration/state-options.html">State Options</a>
</li>
<li><a href="../configuration/countries-options.html">Countries Options</a>
</li>
<li><a href="../configuration/currency.html">Currency</a>
</li>
<li><a href="../configuration/shipping-settings-basic.html">Basic Shipping Settings</a>
</li>
<li><a href="../configuration/email-addresses.html">Store Email Addresses</a>
</li>
<li><a href="../store-operations/contact-us.html">Contact Us</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../design/store-design.html">Storefront Branding</a>
<ul class="sub-menu">
<li><a href="../design/logo-upload.html">Uploading Your Logo</a>
</li>
<li><a href="../design/favicon.html">Adding a Favicon</a>
</li>
<li><a href="../design/welcome-message.html">Welcome Message</a>
</li>
<li><a href="../design/store-demo-notice.html">Store Demo Notice</a>
</li>
<li><a href="../design/copyright-notice.html">Copyright Notice</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../store-operations/stores-multiple.html">Websites, Stores & Views</a>
<ul class="sub-menu">
<li><a href="../store-operations/store-hierarchy.html">Setting Up Store Hierarchy</a>
</li>
<li><a href="../configuration/scope.html">Configuration Scope</a>
</li>
<li><a href="../store-operations/language-add.html">Adding a Language</a>
</li>
<li><a href="../configuration/base-urls.html">Store URLs</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../store-operations/compliance-industry.html">Industry Compliance</a>
<ul class="sub-menu">
<li><a href="../store-operations/compliance-pci.html">PCI Compliance</a>
</li>
<li><a href="../store-operations/compliance-gdpr.html">GDPR Compliance</a>
</li>
<li><a href="../store-operations/privacy-policy.html">Privacy Policy</a>
</li>
<li><a href="../store-operations/compliance-cookie-law.html">Cookie Law Compliance</a>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../products.html">Products</a>
<ul class="sub-menu">
<li class="has-children"><a href="../catalog/navigation.html">Navigation</a>
<ul class="sub-menu">
<li><a href="../catalog/navigation-top.html">Top Navigation</a>
</li>
<li><a href="../catalog/navigation-breadcrumb-trail.html">Breadcrumb Trail</a>
</li>
<li class="has-children"><a href="../catalog/product-list.html">Product Listings</a>
<ul class="sub-menu">
<li><a href="../catalog/pagination.html">Pagination Controls</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/navigation-layered.html">Layered Navigation</a>
<ul class="sub-menu">
<li><a href="../catalog/navigation-layered-filterable-attributes.html">Filterable Attributes</a>
</li>
<li><a href="../catalog/navigation-price.html">Price Navigation</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/categories.html">Categories</a>
<ul class="sub-menu">
<li><a href="../catalog/category-levels.html">Category Levels</a>
</li>
<li class="has-children"><a href="../catalog/category-create.html">Creating Categories</a>
<ul class="sub-menu">
<li><a href="../catalog/category-modify.html">Modifying Categories</a>
</li>
<li><a href="../catalog/category-root.html">Root Categories</a>
</li>
<li><a href="../catalog/category-hidden.html">Hidden Categories</a>
</li>
</ul>
</li>
<li><a href="../catalog/category-general-information.html">General Information</a>
</li>
<li><a href="../catalog/category-display-settings.html">Display Settings</a>
</li>
<li><a href="../catalog/category-custom-design.html">Custom Design</a>
</li>
<li><a href="../catalog/category-products.html">Category Products</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/attributes.html">Attributes</a>
<ul class="sub-menu">
<li class="has-children"><a href="../catalog/attribute-input-types.html">Attribute Input Types</a>
<ul class="sub-menu">
<li><a href="../catalog/attribute-date-time-options.html">Date & Time Options</a>
</li>
</ul>
</li>
<li><a href="../catalog/attribute-create.html">Creating Attributes</a>
</li>
<li><a href="../catalog/attribute-delete.html">Deleting Attributes</a>
</li>
<li><a href="../catalog/attribute-set.html">Creating an Attribute Set</a>
</li>
<li class="has-children"><a href="../catalog/attribute-quick-reference.html">Attribute Quick Reference</a>
<ul class="sub-menu">
<li><a href="../catalog/attribute-properties.html">Attribute Properties</a>
</li>
<li><a href="../catalog/attribute-frontend-properties.html">Attribute Frontend Properties</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/catalog-flat.html">Flat Catalog</a>
<ul class="sub-menu">
<li><a href="../catalog/catalog-flat-setup.html">Flat Catalog Setup</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/product-create.html">Creating Products</a>
<ul class="sub-menu">
<li><a href="../catalog/product-types.html">Product Types</a>
</li>
<li><a href="../catalog/product-simple.html">Simple Product</a>
</li>
<li><a href="../catalog/product-grouped.html">Grouped Product</a>
</li>
<li><a href="../catalog/product-configurable.html">Configurable Product</a>
</li>
<li><a href="../catalog/product-virtual.html">Virtual Product</a>
</li>
<li><a href="../catalog/product-bundle.html">Bundle Product</a>
</li>
<li class="has-children"><a href="../catalog/product-downloadable.html">Downloadable Product</a>
<ul class="sub-menu">
<li><a href="../catalog/product-downloadable-options.html">Product Options</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/product-images.html">Images</a>
<ul class="sub-menu">
<li><a href="../catalog/product-image-thumbnail-gallery.html">Thumbnail Gallery</a>
</li>
<li><a href="../catalog/product-image-size-type.html">Image Size and Type</a>
</li>
<li><a href="../catalog/product-image-add.html">Adding Product Images</a>
</li>
<li><a href="../catalog/product-image-placeholders.html">Placeholders</a>
</li>
<li><a href="../catalog/product-image-watermarks.html">Watermarks</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/product-configurable-swatch.html">Swatches</a>
<ul class="sub-menu">
<li><a href="../catalog/product-configurable-swatch-workflow.html">Swatch Workflow</a>
</li>
<li class="has-children"><a href="../catalog/product-configurable-swatch-setup.html">Swatch Configuration</a>
<ul class="sub-menu">
<li><a href="../catalog/product-configurable-swatch-attribute-values.html">Adding New Attribute Values</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/product-configurable-swatch-image.html">Preparing Swatch Images</a>
<ul class="sub-menu">
<li><a href="../catalog/product-configurable-swatch-image-upload.html">Uploading Swatch Images</a>
</li>
<li><a href="../catalog/product-configurable-swatch-dynamic-image.html">Setting Up Dynamic Images</a>
</li>
<li><a href="../catalog/product-configurable-swatch-localization.html">Swatch Localization</a>
</li>
</ul>
</li>
<li><a href="../catalog/product-configurable-swatch-image-cache.html">Clearing the Cache</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/product-pricing.html">Pricing</a>
<ul class="sub-menu">
<li><a href="../catalog/product-prices.html">Prices</a>
</li>
<li><a href="../catalog/product-price-special.html">Special Price</a>
</li>
<li><a href="../catalog/product-price-tier.html">Tier Price</a>
</li>
<li><a href="../catalog/product-price-package.html">Quantity Increments</a>
</li>
<li class="has-children"><a href="../catalog/product-price-minimum-advertised.html">Minimum Advertised Price </a>
<ul class="sub-menu">
<li><a href="../catalog/product-price-map-logic.html">MAP Logic</a>
</li>
<li><a href="../catalog/product-price-map-config.html">MAP Configuration</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/product-price-group.html">Product Group Price</a>
<ul class="sub-menu">
<li><a href="../catalog/product-price-group-setup.html">Group Price Setup</a>
</li>
<li><a href="../catalog/product-price-group-attribute.html">Group Price Attribute</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/inventory.html">Inventory</a>
<ul class="sub-menu">
<li><a href="../catalog/inventory-setup.html">Inventory Configuration</a>
</li>
<li class="has-children"><a href="../catalog/inventory-manage-stock.html">Managing Stock</a>
<ul class="sub-menu">
<li><a href="../catalog/inventory-stock-options.html">Stock Options</a>
</li>
<li><a href="../catalog/inventory-stock-availability.html">Stock Availability</a>
</li>
<li><a href="../catalog/inventory-product-alert.html">Product Alerts</a>
</li>
<li><a href="../catalog/inventory-configurable-product.html">Managing Configurable Products</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../catalog/product-information.html">Product Information</a>
<ul class="sub-menu">
<li><a href="../catalog/product-general.html">General</a>
</li>
<li><a href="../catalog/product-meta.html">Meta Data</a>
</li>
<li><a href="../catalog/product-recurring-profile.html">Recurring Profile</a>
</li>
<li><a href="../catalog/product-design.html">Design</a>
</li>
<li><a href="../catalog/product-gift-options.html">Gift Options</a>
</li>
<li><a href="../catalog/product-websites.html">Websites</a>
</li>
<li><a href="../catalog/product-categories.html">Categories</a>
</li>
<li><a href="../catalog/product-relationships-related-products.html">Related Products</a>
</li>
<li><a href="../catalog/product-relationships-up-sells.html">Up-sells</a>
</li>
<li><a href="../catalog/product-relationships-cross-sells.html">Cross-sells</a>
</li>
<li><a href="../catalog/product-options-custom.html">Custom Options</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../marketing.html">Marketing</a>
<ul class="sub-menu">
<li class="has-children"><a href="promotions.html">Promotions</a>
<ul class="sub-menu">
<li class="has-children"><a href="price-rules-catalog.html">Catalog Price Rules</a>
<ul class="sub-menu">
<li><a href="price-rule-multiple-sku.html">Multiple SKUs</a>
</li>
</ul>
</li>
<li class="has-children"><a href="price-rules-shopping-cart.html">Shopping Cart Price Rules</a>
<ul class="sub-menu">
<li><a href="price-rules-shopping-cart-coupon.html">Coupon Codes</a>
</li>
<li><a href="price-rule-shopping-cart-free-shipping.html">Free Shipping Promotion</a>
</li>
<li><a href="#" class="selected">Buy X, Get Y Free</a>
</li>
<li><a href="price-rule-discount-minimum-purchase.html">Discount with Minimum Purchase</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="shopping-tools.html">Shopping Tools</a>
<ul class="sub-menu">
<li><a href="customer-engagement.html">Opportunities to Engage</a>
</li>
<li><a href="email-a-friend.html">Email a Friend</a>
</li>
<li><a href="polls.html">Polls</a>
</li>
<li class="has-children"><a href="tags.html">Tags</a>
<ul class="sub-menu">
<li><a href="tags-admin-create.html">Tagging Products by Admin</a>
</li>
<li><a href="tags-moderate.html">Moderating Tags</a>
</li>
</ul>
</li>
<li><a href="wishlist.html">Wishlists</a>
</li>
<li><a href="gift-options.html">Gift Options</a>
</li>
<li><a href="product-relationships.html">Product Relationships</a>
</li>
<li><a href="compare-products.html">Compare Products</a>
</li>
<li><a href="recently-viewed-compared.html">Recently Viewed/Compared Products</a>
</li>
<li class="has-children"><a href="product-reviews.html">Product Reviews</a>
<ul class="sub-menu">
<li><a href="product-reviews-ratings.html">Custom Ratings</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="newsletter.html">Newsletters</a>
<ul class="sub-menu">
<li><a href="newsletter-configuration.html">Newsletter Configuration</a>
</li>
<li><a href="newsletter-templates.html">Newsletter Templates</a>
</li>
<li><a href="newsletter-queue.html">Newsletter Queue</a>
</li>
<li><a href="newsletter-reports.html">Newsletter Reports</a>
</li>
</ul>
</li>
<li class="has-children"><a href="sales-channels.html">Sales Channels</a>
<ul class="sub-menu">
<li><a href="rss-feed.html">RSS Feeds</a>
</li>
<li class="has-children"><a href="social-marketing.html">Social Marketing</a>
<ul class="sub-menu">
<li><a href="facebook-plugins.html">Adding Facebook Plugins</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="google-tools.html">Google Tools</a>
<ul class="sub-menu">
<li><a href="google-merchant-center.html">Google Merchant Center</a>
</li>
<li class="has-children"><a href="google-sitemap.html">Google Sitemap</a>
<ul class="sub-menu">
<li><a href="google-sitemap-configuration.html">Sitemap Configuration</a>
</li>
</ul>
</li>
<li><a href="google-universal-analytics.html">Google Universal Analytics</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../search-seo.html">Search & SEO</a>
<ul class="sub-menu">
<li class="has-children"><a href="../search_seo/storefront-search-tools.html">Storefront Search Tools</a>
<ul class="sub-menu">
<li><a href="../search_seo/search-quick.html">Quick Search</a>
</li>
<li><a href="../search_seo/search-advanced.html">Advanced Search</a>
</li>
<li><a href="../search_seo/search-results.html">Search Results</a>
</li>
<li><a href="../search_seo/search-terms-popular.html">Popular Search Terms</a>
</li>
<li><a href="../search_seo/search-configuration.html">Search Configuration</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../search_seo/search-terms.html">Managing Search Terms</a>
<ul class="sub-menu">
<li><a href="../search_seo/search-terms-new.html">Adding Search Terms</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../search_seo/seo-best-practices.html">SEO Best Practices</a>
<ul class="sub-menu">
<li><a href="../search_seo/seo-meta-information.html">Meta Data</a>
</li>
<li><a href="../search_seo/seo-sitemap.html">Sitemap</a>
</li>
<li><a href="../search_seo/seo-catalog-url-options.html">Catalog URLs</a>
</li>
<li><a href="../search_seo/seo-canonical-meta-tag.html">Canonical Meta Tag</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../search_seo/seo-url-redirect.html">Managing URL Rewrites</a>
<ul class="sub-menu">
<li><a href="../search_seo/seo-url-rewrite-configure.html">Configuring URL Rewrites</a>
</li>
<li><a href="../search_seo/seo-automatic-product-redirects.html">Automatic Product Redirects</a>
</li>
<li><a href="../search_seo/seo-url-redirect-create.html">Creating URL Rewrites</a>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../content.html">Content</a>
<ul class="sub-menu">
<li class="has-children"><a href="../cms/content-management.html">Magento CMS</a>
<ul class="sub-menu">
<li><a href="../cms/magento-cms.html">CMS Tools</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../cms/pages.html">Content Pages</a>
<ul class="sub-menu">
<li class="has-children"><a href="../cms/content-core.html">Core Content</a>
<ul class="sub-menu">
<li><a href="../cms/pages-default.html">Default Pages</a>
</li>
</ul>
</li>
<li><a href="../cms/page-create.html">Creating a Page</a>
</li>
<li class="has-children"><a href="../cms/editor.html">Using the Editor</a>
<ul class="sub-menu">
<li><a href="../cms/links.html">Inserting a Link</a>
</li>
<li><a href="../cms/editor-insert-image.html">Inserting Images</a>
</li>
<li><a href="../cms/editor-add-widget.html">Adding a Widget</a>
</li>
</ul>
</li>
<li><a href="../cms/media-storage.html">Media Storage</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../cms/blocks.html">Blocks</a>
<ul class="sub-menu">
<li><a href="../cms/block-create.html">Creating a Static Block</a>
</li>
<li><a href="../cms/block-position.html">Positioning Blocks</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../cms/widgets.html">Widgets</a>
<ul class="sub-menu">
<li><a href="../cms/widget-types.html">Widget Types</a>
</li>
<li class="has-children"><a href="../cms/widget-create.html">Creating a Widget</a>
<ul class="sub-menu">
<li><a href="../cms/widget-static-block.html">Static Block</a>
</li>
<li><a href="../cms/widget-new-products-list.html">New Products List</a>
</li>
<li><a href="../cms/widget-mini-shopping-cart.html">Mini Shopping Cart</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../cms/variables.html">Variables</a>
<ul class="sub-menu">
<li><a href="../cms/variables-predefined.html">Predefined Variables</a>
</li>
<li><a href="../cms/variables-custom.html">Custom Variables</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../cms/markup-tags.html">Markup Tags</a>
<ul class="sub-menu">
<li><a href="../cms/markup-tag-syntax.html">Markup Tag Syntax</a>
</li>
<li><a href="../cms/markup-tags-links.html">Using Markup Tags in Links</a>
</li>
<li><a href="../cms/markup-tag-category-list-home-page.html">Category List on Home Page</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../design.html">Design</a>
<ul class="sub-menu">
<li class="has-children"><a href="../design/page-layout.html">Page Layout</a>
<ul class="sub-menu">
<li><a href="../design/page-layout-variations.html">Standard Layouts</a>
</li>
<li><a href="../design/page-column-layout.html">Storefront Examples</a>
</li>
<li><a href="../design/layout-updates.html">Layout Updates</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../design/page-setup.html">Page Setup</a>
<ul class="sub-menu">
<li><a href="../design/page-html-head.html">HTML Head</a>
</li>
<li><a href="../design/page-header.html">Page Header</a>
</li>
<li><a href="../design/page-footer.html">Page Footer</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../design/themes.html">Your Store's Theme</a>
<ul class="sub-menu">
<li><a href="../design/package.html">Design Packages</a>
</li>
<li><a href="../design/theme-assets.html">Theme Assets</a>
</li>
<li><a href="../design/theme-rwd.html">Responsive Design</a>
</li>
<li><a href="../design/theme-change.html">Installing a New Theme</a>
</li>
<li><a href="../design/theme-scheduling-changes.html">Scheduling Design Changes</a>
</li>
<li><a href="../design/interface-text-change.html">Changing UI Text</a>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../customers.html">Customers</a>
<ul class="sub-menu">
<li class="has-children"><a href="../customers/customer-accounts.html">Customer Accounts</a>
<ul class="sub-menu">
<li><a href="../customers/customer-account-login.html">Customer Account Login</a>
</li>
<li><a href="../customers/account-dashboard.html">Account Dashboard</a>
</li>
<li class="has-children"><a href="../customers/account-configuration.html">Account Configuration</a>
<ul class="sub-menu">
<li><a href="../customers/account-scope.html">Account Scope</a>
</li>
<li><a href="../customers/login-landing-page.html">Login Landing Page</a>
</li>
<li><a href="../customers/name-address-options.html">Name and Address Options</a>
</li>
<li><a href="../customers/password-options.html">Password Options</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../customers/customer-groups.html">Customer Groups</a>
<ul class="sub-menu">
<li><a href="../customers/customer-group-create.html">Creating a Customer Group</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../sales.html">Sales</a>
<ul class="sub-menu">
<li class="has-children"><a href="../sales/shopping-cart.html">Shopping Cart</a>
<ul class="sub-menu">
<li class="has-children"><a href="../sales/shopping-cart-configure.html">Cart Configuration</a>
<ul class="sub-menu">
<li><a href="../sales/shopping-cart-redirect.html">Redirect to Cart</a>
</li>
<li><a href="../sales/shopping-cart-quote-lifetime.html">Quote Lifetime</a>
</li>
<li><a href="../sales/minimum-order.html">Minimum Order</a>
</li>
<li><a href="../catalog/product-image-shopping-cart-thumbnails.html">Shopping Cart Thumbnails</a>
</li>
<li><a href="../sales/shopping-cart-my-cart-link.html">My Cart Link</a>
</li>
</ul>
</li>
<li><a href="../sales/shopping-cart-mini.html">Mini Cart</a>
</li>
<li class="has-children"><a href="../sales/shopping-cart-persistent.html">Persistent Cart</a>
<ul class="sub-menu">
<li><a href="../sales/shopping-cart-persistent-cookie-scenarios.html">Persistent Cart Workflow</a>
</li>
<li><a href="../sales/shopping-cart-persistent-setup.html">Persistent Cart Configuration</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../sales/shopping-assisted.html">Shopping Assistance</a>
<ul class="sub-menu">
<li><a href="../order-processing/customers-online.html">View Online Customers</a>
</li>
<li><a href="../sales/shopping-assisted-cart-edit.html">Update a Shopping Cart</a>
</li>
<li class="has-children"><a href="../order-processing/order-create.html">Create an Order</a>
<ul class="sub-menu">
<li><a href="../order-processing/order-update.html">Update an Order</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../customers/customer-account-create.html">Create a Customer Account</a>
<ul class="sub-menu">
<li><a href="../customers/account-options-basic.html">Basic New Account Options</a>
</li>
<li><a href="../customers/customers-edit.html">Update Customer Account</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../sales/checkout.html">Checkout</a>
<ul class="sub-menu">
<li><a href="../sales/checkout-process.html">Checkout Process</a>
</li>
<li class="has-children"><a href="../sales/checkout-guest.html">Checkout Method</a>
<ul class="sub-menu">
<li><a href="../sales/checkout-onepage.html">One Page Checkout</a>
</li>
</ul>
</li>
<li><a href="../sales/order-review.html">Order Review</a>
</li>
<li><a href="../sales/terms-conditions.html">Terms and Conditions</a>
</li>
<li><a href="../sales/order-confirmation.html">Order Confirmation</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../order-processing/sales-document-setup.html">Sales Communications</a>
<ul class="sub-menu">
<li><a href="../order-processing/sales-email-setup.html">Setting Up Sales Email</a>
</li>
<li><a href="../order-processing/sales-document-logo.html">PDF Logo Requirements</a>
</li>
<li><a href="../order-processing/sales-documents-order-id.html">Adding Reference IDs</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../order-processing/order-manage.html">Managing Orders</a>
<ul class="sub-menu">
<li><a href="../order-processing/order-process-overview.html">Process Overview</a>
</li>
<li><a href="../order-processing/order-stages.html">Order Stages</a>
</li>
<li class="has-children"><a href="../order-processing/order-status.html">Order Status</a>
<ul class="sub-menu">
<li><a href="../order-processing/order-status-custom.html">Custom Order Status</a>
</li>
</ul>
</li>
<li><a href="../order-processing/order-workflow.html">Order Workflow</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../order-processing/order-fulfillment.html">Order Fulfillment</a>
<ul class="sub-menu">
<li class="has-children"><a href="../order-processing/order-invoice.html">Invoice an Order</a>
<ul class="sub-menu">
<li><a href="../order-processing/order-invoice-print.html">Print Invoices</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../order-processing/order-ship.html">Ship an Order</a>
<ul class="sub-menu">
<li><a href="../order-processing/packing-slips.html">Packing Slips</a>
</li>
</ul>
</li>
<li><a href="../order-processing/sales-transactions.html">Transactions</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../order-processing/credit-refunds.html">Credit Memos & Refunds</a>
<ul class="sub-menu">
<li><a href="../order-processing/return-product-workflow.html">Product Return Workflow</a>
</li>
<li class="has-children"><a href="../order-processing/credit-memo-create.html">Create Credit Memo</a>
<ul class="sub-menu">
<li><a href="../order-processing/credit-memo-print.html">Print Credit Memo</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../payments.html">Payments</a>
<ul class="sub-menu">
<li class="has-children"><a href="../payment/payment-methods.html">Basic Payment Methods</a>
<ul class="sub-menu">
<li><a href="../payment/merchant-location.html">Merchant Location</a>
</li>
<li><a href="../payment/bank-transfer.html">Bank Transfer Payment</a>
</li>
<li><a href="../payment/cash-on-delivery.html">Cash On Delivery</a>
</li>
<li><a href="../payment/check-money-order.html">Check / Money Order</a>
</li>
<li><a href="../payment/purchase-order.html">Purchase Order</a>
</li>
<li><a href="../payment/zero-subtotal-checkout.html">Zero Subtotal Checkout</a>
</li>
<li><a href="../payment/saved-cc.html">Saved Credit Cards</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../payment/paypal.html">PayPal Payment Solutions</a>
<ul class="sub-menu">
<li><a href="../payment/paypal-business-account.html">PayPal Business Account</a>
</li>
<li><a href="../payment/paypal-credit.html">PayPal Credit</a>
</li>
<li><a href="../payment/paypal-payment-advanced-intro.html">PayPal Payments Advanced</a>
</li>
<li><a href="../payment/paypal-payments-pro-intro.html">PayPal Payments Pro</a>
</li>
<li><a href="../payment/paypal-payment-standard-intro.html">PayPal Payments Standard</a>
</li>
<li><a href="../payment/paypal-express-checkout-intro.html">PayPal Express Checkout</a>
</li>
<li><a href="../payment/paypal-payflow-pro.html">PayPal Payflow Pro</a>
</li>
<li><a href="../payment/paypal-payflow-link.html">PayPal Payflow Link</a>
</li>
<li><a href="../payment/paypal-fraud-management-filter.html">PayPal Fraud Management Filter</a>
</li>
<li><a href="../payment/paypal-countries.html">PayPal Solutions by Country</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../payment/gateways.html">Payment Gateways</a>
<ul class="sub-menu">
<li><a href="../payment/solutions-by-region.html">Payment Solutions by Region</a>
</li>
<li><a href="../payment/test-credentials.html">Testing Credentials</a>
</li>
<li><a href="../payment/authorize-net.html">Authorize.Net</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../payment/payment-services.html">Payment Services</a>
<ul class="sub-menu">
<li><a href="../payment/3d-secure-credit-card-validation.html">3D Secure Credit Card Validation</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../shipping.html">Shipping</a>
<ul class="sub-menu">
<li class="has-children"><a href="../shipping/shipping-methods.html">Basic Shipping Methods</a>
<ul class="sub-menu">
<li><a href="../shipping/shipping-settings.html">Shipping Settings</a>
</li>
<li><a href="../shipping/flat-rate.html">Flat Rate</a>
</li>
<li><a href="../shipping/free-shipping.html">Free Shipping</a>
</li>
<li><a href="../shipping/table-rates.html">Table Rates </a>
</li>
<li><a href="../shipping/online-rates.html">Online Rates</a>
</li>
<li><a href="../shipping/weight-dimensional.html">Dimensional Weight</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../shipping/carriers.html">Shipping Carriers</a>
<ul class="sub-menu">
<li><a href="../shipping/ups.html">UPS</a>
</li>
<li><a href="../shipping/usps.html">USPS</a>
</li>
<li><a href="../shipping/fedex.html">FedEx</a>
</li>
<li><a href="../shipping/dhl.html">DHL</a>
</li>
<li><a href="../shipping/package-types.html">Package Type by Carrier</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../shipping/shipping-labels.html">Shipping Labels</a>
<ul class="sub-menu">
<li><a href="../shipping/shipping-label-workflow.html">Shipping Label Workflow</a>
</li>
<li><a href="../shipping/shipping-label-setup.html">Shipping Label Setup</a>
</li>
<li><a href="../shipping/shipping-labels-create.html">Creating Shipping Labels</a>
</li>
<li><a href="../shipping/shipping-labels-create-packages.html">Creating a Package</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../taxes.html">Taxes</a>
<ul class="sub-menu">
<li class="has-children"><a href="../tax/taxes.html">Managing Taxes</a>
<ul class="sub-menu">
<li><a href="../tax/tax-settings-general.html">General Tax Settings</a>
</li>
<li><a href="../tax/tax-classes.html">Tax Classes</a>
</li>
<li><a href="../tax/tax-zones-rates.html">Tax Zones & Rates</a>
</li>
<li><a href="../tax/tax-rules.html">Tax Rules</a>
</li>
<li><a href="../tax/tax-fixed-product.html">Fixed Product Tax</a>
</li>
<li><a href="../tax/tax-compound.html">Compound Taxes</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../tax/vat.html">Value Added Tax (VAT)</a>
<ul class="sub-menu">
<li><a href="../tax/vat-validation.html">VAT ID Validation</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../tax/quick-reference.html">Quick Reference</a>
<ul class="sub-menu">
<li><a href="../tax/international-configurations.html">International Configurations</a>
</li>
<li><a href="../tax/warning-messages.html">Tax Warning Messages</a>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../reports.html">Reports</a>
<ul class="sub-menu">
<li class="has-children"><a href="../store-operations/reports-dashboard.html">Dashboard</a>
<ul class="sub-menu">
<li><a href="../store-operations/reports-snapshot.html">Snapshot Reports</a>
</li>
<li><a href="../store-operations/reports-dashboard-setup.html">Dashboard Setup</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../store-operations/reports-generating.html">Running Reports</a>
<ul class="sub-menu">
<li><a href="../store-operations/reports-refresh.html">Refreshing Report Statistics</a>
</li>
<li><a href="../store-operations/reports-available.html">Available Reports</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../operations.html">Operations</a>
<ul class="sub-menu">
<li class="has-children"><a href="../store-operations.html">Stores</a>
<ul class="sub-menu">
<li class="has-children"><a href="../store-operations/currency-rates.html">Currency Rates</a>
<ul class="sub-menu">
<li><a href="../configuration/currency-setup.html">Currency Configuration</a>
</li>
<li><a href="../store-operations/currency-symbols.html">Currency Symbols</a>
</li>
<li><a href="../store-operations/currency-rates-update.html">Updating Currency Rates</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../store-operations/email-transactional.html">Email Templates</a>
<ul class="sub-menu">
<li><a href="../store-operations/email-clients-supported.html">Supported Email Clients</a>
</li>
<li><a href="../store-operations/email-template-layout-styles.html">Template Layout and Styles</a>
</li>
<li><a href="../store-operations/email-template-update.html">Updating Default Templates</a>
</li>
<li><a href="../store-operations/email-template-custom.html">Creating Custom Templates</a>
</li>
<li><a href="../store-operations/email-template-configuration.html">Email Template Configuration</a>
</li>
<li><a href="../store-operations/email-template-reference.html">Email Template Reference</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../store-operations/data-transfer-manage.html">Data Transfer</a>
<ul class="sub-menu">
<li><a href="../store-operations/data-csv-files.html">Working with CSV Files</a>
</li>
<li><a href="../store-operations/data-import.html">Import</a>
</li>
<li><a href="../store-operations/data-export.html">Export</a>
</li>
<li><a href="../store-operations/dataflow.html">Dataflow</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../store-operations/permissions.html">Permissions</a>
<ul class="sub-menu">
<li><a href="../store-operations/permissions-user-new.html">New Users</a>
</li>
<li><a href="../store-operations/permissions-role-custom.html">Custom Roles</a>
</li>
<li><a href="../store-operations/permissions-content.html">Content</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../store-operations/security.html">Security</a>
<ul class="sub-menu">
<li><a href="../magento/magento-security-best-practices.html">Security Best Practices</a>
</li>
<li><a href="../store-operations/security-configuration.html">Security Configuration</a>
</li>
<li><a href="../store-operations/security-captcha.html">CAPTCHA</a>
</li>
<li><a href="../system-operations/session-validation.html">Session Validation</a>
</li>
<li><a href="../system-operations/browser-capabilities-detection.html">Browser Capabilities Detection</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../system-operations.html">System</a>
<ul class="sub-menu">
<li class="has-children"><a href="../system-operations/index-management.html">Index Management</a>
<ul class="sub-menu">
<li><a href="../system-operations/index-manual.html">Manual Reindexing</a>
</li>
<li><a href="../system-operations/index-modes.html">Automatic Indexing</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../system-operations/cache-management.html">Cache Storage</a>
<ul class="sub-menu">
<li><a href="../system-operations/cache-clear.html">Clearing Caches</a>
</li>
<li><a href="../system-operations/cache-page-external.html">External Full-Page Cache</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../system-operations/media-storage.html">Alternate Media Storage</a>
<ul class="sub-menu">
<li><a href="../system-operations/media-storage-database.html">Database Configuration</a>
</li>
<li><a href="../system-operations/media-storage-cdn.html">CDN Configuration</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../magento/magento-marketplace.html">Magento Marketplace</a>
<ul class="sub-menu">
<li><a href="../magento/magento-connect.html">Magento Connect</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../system-operations/web-services.html">Web Services</a>
<ul class="sub-menu">
<li><a href="../system-operations/web-services-core-api-settings.html">Magento Core API Settings</a>
</li>
<li><a href="../system-operations/web-services-activate.html">Activating Web Services</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../system-operations/system-tools.html">System Tools</a>
<ul class="sub-menu">
<li><a href="../system-operations/server-backup-rollback.html">Backups</a>
</li>
<li><a href="../magento/installing-magento-patches.html">Patches</a>
</li>
<li><a href="../system-operations/system-tools-compilation.html">Compilation</a>
</li>
<li><a href="../system-operations/system-log.html">System Log</a>
</li>
<li><a href="../system-operations/cron.html">Cron</a>
</li>
<li><a href="../magento/magento-test-framework.html">Magento Test Framework</a>
</li>
<li><a href="../magento/database-repair-tool.html">Database Repair</a>
</li>
</ul>
</li>
<li><a href="../system-operations/configuration-overview.html">Configuration</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="has-children"><a href="../reference.html">Reference</a>
<ul class="sub-menu">
<li><a href="../magento/release-notes.html">Release Notes</a>
</li>
<li><a href="../magento/questions-and-answers.html">Q & A</a>
</li>
<li><a href="../magento/change-log.html">Change Log</a>
</li>
<li><a href="../backmatter/glossary.html">Glossary</a>
</li>
<li><a href="../magento/archive.html">Documentation Archive</a>
</li>
<li class="has-children"><a href="../configuration/reference.html">Configuration Reference</a>
<ul class="sub-menu">
<li class="has-children"><a href="../configuration/general.html">General</a>
<ul class="sub-menu">
<li><a href="../configuration/general/general.html">General</a>
</li>
<li><a href="../configuration/general/web.html">Web</a>
</li>
<li><a href="../configuration/general/design.html">Design</a>
</li>
<li><a href="../configuration/general/currency-setup.html">Currency Setup</a>
</li>
<li><a href="../configuration/general/store-email-addresses.html">Store Email Addresses</a>
</li>
<li><a href="../configuration/general/contacts.html">Contacts</a>
</li>
<li><a href="../configuration/general/reports.html">Reports</a>
</li>
<li><a href="../configuration/general/content-management.html">Content Management</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../configuration/catalog.html">Catalog</a>
<ul class="sub-menu">
<li><a href="../configuration/catalog/catalog.html">Catalog</a>
</li>
<li><a href="../configuration/catalog/configurable-swatches.html">Configurable Swatches</a>
</li>
<li><a href="../configuration/catalog/inventory.html">Inventory</a>
</li>
<li><a href="../configuration/catalog/google-sitemap.html">Google Sitemap</a>
</li>
<li><a href="../configuration/catalog/rss-feeds.html">RSS Feeds</a>
</li>
<li><a href="../configuration/catalog/email-to-a-friend.html">Email to a Friend</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../configuration/customers.html">Customers</a>
<ul class="sub-menu">
<li><a href="../configuration/customers/newsletter.html">Newsletter</a>
</li>
<li><a href="../configuration/customers/customer-configuration.html">Customer Configuration</a>
</li>
<li><a href="../configuration/customers/wishlist.html">Wishlist</a>
</li>
<li><a href="../configuration/customers/promotions.html">Promotions</a>
</li>
<li><a href="../configuration/customers/persistent-shopping-cart.html">Persistent Shopping Cart</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../configuration/sales.html">Sales</a>
<ul class="sub-menu">
<li><a href="../configuration/sales/sales.html">Sales</a>
</li>
<li><a href="../configuration/sales/sales-emails.html">Sales Emails</a>
</li>
<li><a href="../configuration/sales/pdf-print-outs.html">PDF Print-outs</a>
</li>
<li><a href="../configuration/sales/tax.html">Tax</a>
</li>
<li><a href="../configuration/sales/checkout.html">Checkout</a>
</li>
<li><a href="../configuration/sales/shipping-settings.html">Shipping Settings</a>
</li>
<li><a href="../configuration/sales/shipping-methods.html">Shipping Methods</a>
</li>
<li><a href="../configuration/sales/google-api.html">Google API</a>
</li>
<li><a href="../configuration/sales/payment-methods.html">Payment Methods</a>
</li>
<li><a href="../configuration/sales/payment-services.html">Payment Services</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../configuration/services.html">Services</a>
<ul class="sub-menu">
<li><a href="../configuration/services/magento-core-api.html">Magento Core API</a>
</li>
<li><a href="../configuration/services/oauth.html">OAuth</a>
</li>
</ul>
</li>
<li class="has-children"><a href="../configuration/advanced.html">Advanced</a>
<ul class="sub-menu">
<li><a href="../configuration/advanced/admin.html">Admin</a>
</li>
<li><a href="../configuration/advanced/system.html">System</a>
</li>
<li><a href="../configuration/advanced/advanced.html">Advanced</a>
</li>
<li><a href="../configuration/advanced/developer.html">Developer</a>
</li>
</ul>
</li>
</ul>
</li>
<li><a href="https://magento.com/resources/technical" target="_blank">Documentation Resources</a>
</li>
</ul>
</li>
</ul>
</div><a class="menu-icon left-off-canvas-toggle" href="#"><span></span></a>
</div>
</section>
</nav>
<aside class="left-off-canvas-menu" data-mc-ignore="true">
<ul class="off-canvas-list" data-mc-back-link="Back" data-mc-css-tree-node-expanded="has-submenu" data-mc-css-tree-node-collapsed="has-submenu" data-mc-css-sub-menu="left-submenu" data-mc-include-indicator="False" data-mc-include-icon="False" data-mc-include-parent-link="True" data-mc-include-back="True" data-mc-defer-expand-event="True" data-mc-expand-event="click.fndtn.offcanvas" data-mc-toc="True">
</ul>
</aside>
<section class="main-section">
<div class="row outer-row" data-mc-content-body="True">
<div class="toolbarWrapper">
<div class="buttons clearfix topicToolbarProxy _Skins_TopicToolBar" style="mc-topic-toolbar-items: RemoveHighlight CollapseAll Print;">
<div class="button-group-container-left">
<button class="button needs-pie print-button" type="button" title="Print">
<img src="../Skins/Default/Stylesheets/Images/transparent.gif" alt="print" />
</button>
<button class="button needs-pie remove-highlight-button" type="button" title="Remove Highlights">
<img src="../Skins/Default/Stylesheets/Images/transparent.gif" alt="remove highlight" />
</button>
<button class="button needs-pie expand-all-button" type="button" data-state1-class="expand-all-button" data-state2-class="collapse-all-button" data-state2-title="Collapse all" title="Expand all" data-state1-title="Expand all">
<img src="../Skins/Default/Stylesheets/Images/transparent.gif" alt="expand all" />
</button>
<div class="button-separator">
</div>
</div>
</div>
</div>
<div class="breadcrumbProxy">
<div class="MCBreadcrumbsBox_0"><span class="MCBreadcrumbsPrefix">You are here: </span><a class="MCBreadcrumbsLink" href="../marketing.html">Marketing</a><span class="MCBreadcrumbsDivider"> > </span><a class="MCBreadcrumbsLink" href="promotions.html">Promotions</a><span class="MCBreadcrumbsDivider"> > </span><a class="MCBreadcrumbsLink" href="price-rules-shopping-cart.html">Shopping Cart Price Rules</a><span class="MCBreadcrumbsDivider"> > </span><span class="MCBreadcrumbs">Buy X, Get Y Free</span>
</div>
</div>
<div class="productVersion"><span class="ProdVer"><span class="MyVariablesProduct">Magento Open Source</span>, <span class="MyVariablesRelease">1.9.x</span></span>
</div>
<div id="searchBox" class="tabletOnly">
<form class="search" action="#">
<div class="search-bar search-bar-container needs-pie">
<input class="search-field needs-pie" type="search" placeholder="Search" />
<div class="search-filter-wrapper">
<div class="search-filter">
<div class="search-filter-content">
<ul>
<li>All Files</li>
</ul>
</div>
</div>
</div>
<div class="search-submit-wrapper" dir="ltr">
<div class="search-submit" title="Search">
</div>
</div>
</div>
</form>
</div>
<p> <![CDATA[ ]]></p>
<div>
<p class="note"><b class="ContrastDark">Magento 1.x Security Patch Notice</b>
<br />For Magento Open Source 1.5 to 1.9, Magento is providing software security patches through June 2020 to ensure those sites remain secure and compliant. Visit our <a href="https://info2.magento.com/M1OpenSource.html" target="_blank">information page</a> for more details about our software maintenance policy and other considerations for your business.</p>
</div>
<div class="bodyProxy">
<div class="Next" data-mc-conditions="Default.ScreenOnly"><a href="price-rule-discount-minimum-purchase.html"><img src="../Resources/Images/assets/next.png" /></a>
</div>
<div class="pageTitleContainer">
<h5>Buy X Get Y Free</h5>
</div>
<p>This example shows how to set up a <a href="price-rules-shopping-cart.html">shopping cart price rule</a> for a “Buy X, Get Y Free” promotion. The format of the discount is as follows: <a name="kanchor357"></a><a name="aanchor127"></a><MadCap:concept term="price rules - shopping cart;promotions" /><a name="kanchor358"></a></p>
<ul class="TableInBody">
<li class="NoBullet" value="1">
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/Code.css');margin-left: 0;margin-right: auto;" class="TableStyle-Code" cellspacing="0">
<col class="TableStyle-Code-Column-Column2" style="width: 100%;" />
<tbody>
<tr class="TableStyle-Code-Body-Body1">
<td class="TableStyle-Code-BodyA-Column2-Body1"><pre xml:space="preserve" class="TableCell">Buy X quantity of product, get Y quantity for free.</pre>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
<div class="MCDropDown MCDropDown_Open dropDown"><span class="MCDropDownHead dropDownHead dropDownHeadToDo"><a href="javascript:void(0);" class="MCDropDownHotSpot dropDownHotspot dropDownHotspotToDo MCDropDownHotSpot_"><img class="MCDropDown_Image_Icon" src="../Skins/Default/Stylesheets/Images/transparent.gif" height="13" width="16" alt="Closed" data-mc-alt2="Open" /><b class="Contrast">Step 1: </b>Create a Shopping Cart Price Rule</a><a name="step1"></a></span>
<div class="MCDropDownBody dropDownBody">
<p class="dropdown_flushLeft">Complete <a href="price-rules-shopping-cart.html">Step 1</a> of the shopping cart price rule instructions to create a shopping cart rule with the general information.</p>
</div>
</div>
<div class="MCDropDown MCDropDown_Open dropDown"><span class="MCDropDownHead dropDownHead dropDownHeadToDo"><a href="javascript:void(0);" class="MCDropDownHotSpot dropDownHotspot dropDownHotspotToDo MCDropDownHotSpot_"><img class="MCDropDown_Image_Icon" src="../Skins/Default/Stylesheets/Images/transparent.gif" height="13" width="16" alt="Closed" data-mc-alt2="Open" /><b class="Contrast">Step 2: </b>Define the Conditions</a><a name="step2"></a></span>
<div class="MCDropDownBody dropDownBody">
<p class="dropdown_flushLeft">Complete <a href="price-rules-shopping-cart.html">Step 2</a> of the shopping cart instructions to define the conditions for the price rule. The conditions can be triggered by purchasing a specific product, making a purchase of a certain amount, or any other scenario.</p>
</div>
</div>
<div class="MCDropDown MCDropDown_Open dropDown"><span class="MCDropDownHead dropDownHead dropDownHeadToDo"><a href="javascript:void(0);" class="MCDropDownHotSpot dropDownHotspot dropDownHotspotToDo MCDropDownHotSpot_"><img class="MCDropDown_Image_Icon" src="../Skins/Default/Stylesheets/Images/transparent.gif" height="13" width="16" alt="Closed" data-mc-alt2="Open" /><b class="Contrast">Step 3: </b>Define the Actions</a><a name="step3"></a></span>
<div class="MCDropDownBody dropDownBody">
<table class="AutoNumber_p_Number1" style="width: 100%; margin-left: 0;" cellspacing="0" cellpadding="0">
<col style="width: -3px;" />
<col style="width: 28px;" />
<col style="width: auto;" />
<tr>
<td valign="top" />
<td class="AutoNumber_p_Number12" valign="top"><span><span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>1.</b></span></span></span>
</td>
<td class="AutoNumber_p_Number1" valign="top" data-mc-autonum="<span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>1.</b></span></span>">In the panel on the left, select <b class="Command">Actions</b>. Then, do the following:</td>
</tr>
</table>
<table class="AutoNumber_p_Alpha1" style="width: 100%; margin-left: 0;" cellspacing="0" cellpadding="0">
<col style="width: 30px;" />
<col style="width: 28px;" />
<col style="width: auto;" />
<tr>
<td valign="top" />
<td class="AutoNumber_p_Alpha12" valign="top"><span><span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>a.</b></span></span></span>
</td>
<td class="AutoNumber_p_Alpha1" valign="top" data-mc-autonum="<span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>a.</b></span></span>">Set <b class="Command">Apply</b> to “Buy X get Y free (discount amount is Y).”</td>
</tr>
</table>
<table class="AutoNumber_p_Alpha1" style="width: 100%; margin-left: 0;" cellspacing="0" cellpadding="0">
<col style="width: 30px;" />
<col style="width: 28px;" />
<col style="width: auto;" />
<tr>
<td valign="top" />
<td class="AutoNumber_p_Alpha12" valign="top"><span><span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>b.</b></span></span></span>
</td>
<td class="AutoNumber_p_Alpha1" valign="top" data-mc-autonum="<span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>b.</b></span></span>">Set <b class="Command">Discount Amount</b> to 1. This is the quantity the customer will receive for free.</td>
</tr>
</table>
<table class="AutoNumber_p_Alpha1" style="width: 100%; margin-left: 0;" cellspacing="0" cellpadding="0">
<col style="width: 30px;" />
<col style="width: 28px;" />
<col style="width: auto;" />
<tr>
<td valign="top" />
<td class="AutoNumber_p_Alpha12" valign="top"><span><span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>c.</b></span></span></span>
</td>
<td class="AutoNumber_p_Alpha1" valign="top" data-mc-autonum="<span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>c.</b></span></span>">To limit the number of discounts that can be applied when the condition is met, enter the number in the <b class="Command">Maximum Qty Discount is Applied To</b> field. For example, enter “1” to discount only one item.</td>
</tr>
</table>
<table class="AutoNumber_p_Alpha1" style="width: 100%; margin-left: 0;" cellspacing="0" cellpadding="0">
<col style="width: 30px;" />
<col style="width: 28px;" />
<col style="width: auto;" />
<tr>
<td valign="top" />
<td class="AutoNumber_p_Alpha12" valign="top"><span><span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>d.</b></span></span></span>
</td>
<td class="AutoNumber_p_Alpha1" valign="top" data-mc-autonum="<span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>d.</b></span></span>">In the <b class="Command">Discount Qty Step (Buy X)</b> field, enter the quantity that the customer must purchase to qualify for the discount.</td>
</tr>
</table>
<div class="Image"><a class="MCPopupThumbnailLink MCPopupThumbnailPopup" href="../Resources/Images/price-rule-action-buy-x-get-y.png"><img class="MCPopupThumbnail img imglarge" data-mc-width="868" data-mc-height="299" src="../Resources/Images/price-rule-action-buy-x-get-y_thumb_0_0.png" tabindex="" /></a>
<br />Buy X Get Y Free</div>
<table class="AutoNumber_p_Number1" style="width: 100%; margin-left: 0;" cellspacing="0" cellpadding="0">
<col style="width: -3px;" />
<col style="width: 28px;" />
<col style="width: auto;" />
<tr>
<td valign="top" />
<td class="AutoNumber_p_Number12" valign="top"><span><span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>2.</b></span></span></span>
</td>
<td class="AutoNumber_p_Number1" valign="top" data-mc-autonum="<span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>2.</b></span></span>">Click the <b class="Command">Save and Continue Edit</b> button. Then, complete the rest of the rule as needed.</td>
</tr>
</table>
</div>
</div>
<div class="MCDropDown MCDropDown_Open dropDown"><span class="MCDropDownHead dropDownHead dropDownHeadToDo"><a href="javascript:void(0);" class="MCDropDownHotSpot dropDownHotspot dropDownHotspotToDo MCDropDownHotSpot_"><img class="MCDropDown_Image_Icon" src="../Skins/Default/Stylesheets/Images/transparent.gif" height="13" width="16" alt="Closed" data-mc-alt2="Open" /><b class="Contrast">Step 4: </b>Complete the Label</a><a name="step4"></a></span>
<div class="MCDropDownBody dropDownBody">
<p class="dropdown_flushLeft">Complete <a href="price-rules-shopping-cart.html">Step 4</a> of the shopping cart price rule instructions to enter the label that appears during checkout.</p>
</div>
</div>
<div class="MCDropDown MCDropDown_Open dropDown"><span class="MCDropDownHead dropDownHead dropDownHeadToDo"><a href="javascript:void(0);" class="MCDropDownHotSpot dropDownHotspot dropDownHotspotToDo MCDropDownHotSpot_"><img class="MCDropDown_Image_Icon" src="../Skins/Default/Stylesheets/Images/transparent.gif" height="13" width="16" alt="Closed" data-mc-alt2="Open" /><b class="Contrast">Step 5: </b>Apply the Rule</a><a name="step5"></a></span>
<div class="MCDropDownBody dropDownBody">
<table class="AutoNumber_p_Number1" style="width: 100%; margin-left: 0;" cellspacing="0" cellpadding="0">
<col style="width: -3px;" />
<col style="width: 28px;" />
<col style="width: auto;" />
<tr>
<td valign="top" />
<td class="AutoNumber_p_Number12" valign="top"><span><span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>1.</b></span></span></span>
</td>
<td class="AutoNumber_p_Number1" valign="top" data-mc-autonum="<span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>1.</b></span></span>">When complete, click the <b class="Command">Save Rule</b> button.</td>
</tr>
</table>
<table class="AutoNumber_p_Number1" style="width: 100%; margin-left: 0;" cellspacing="0" cellpadding="0">
<col style="width: -3px;" />
<col style="width: 28px;" />
<col style="width: auto;" />
<tr>
<td valign="top" />
<td class="AutoNumber_p_Number12" valign="top"><span><span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>2.</b></span></span></span>
</td>
<td class="AutoNumber_p_Number1" valign="top" data-mc-autonum="<span style="font-family: 'Arial';" class="mcFormatFamily"><span style="color: #a84b27;" class="mcFormatColor"><b>2.</b></span></span>">When you create a new price rule, it might take an hour or so for it to become available. Allow enough time for it to get into the system. Then, test the rule to make sure that it works correctly. Unless otherwise specified, price rules are automatically processed with other system rules each night.</td>
</tr>
</table>
</div>
</div>
<p class="TableHeading">Examples</p>
<p>Buy X Get Y Free is processed as a single action, with a “row total” dependency. All items must be from the same SKU to qualify for the promotion. For example:</p>
<ul class="TableInBody">
<li class="NoBullet" value="1">
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/Code.css');margin-left: 0;margin-right: auto;" class="TableStyle-Code" cellspacing="0">
<col class="TableStyle-Code-Column-Column2" style="width: 100%;" />
<tbody>
<tr class="TableStyle-Code-Body-Body1">
<td class="TableStyle-Code-BodyA-Column2-Body1"><pre xml:space="preserve" class="TableCell">Buy X quantity of product from category A, get Y quantity of the same product for free.</pre>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
<p>To limit the free product to categories A, B, and C, set the action as follows:</p>
<ul class="TableInBody">
<li class="NoBullet" value="1">
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/Code.css');margin-left: 0;margin-right: auto;" class="TableStyle-Code" cellspacing="0">
<col class="TableStyle-Code-Column-Column2" style="width: 100%;" />
<tbody>
<tr class="TableStyle-Code-Body-Body1">
<td class="TableStyle-Code-BodyA-Column2-Body1"><pre xml:space="preserve" class="TableCell">If ALL of these conditions are TRUE:</pre><pre xml:space="preserve" class="TableCell">Category is one of A, B, C</pre>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
<p>To limit the free items from any category A, B, C and receive Y from SKUs D123, E123, F123, set the action as follows:</p>
<ul class="TableInBody">
<li class="NoBullet" value="1">
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/Code.css');margin-left: 0;margin-right: auto;" class="TableStyle-Code" cellspacing="0">
<col class="TableStyle-Code-Column-Column2" style="width: 100%;" />
<tbody>
<tr class="TableStyle-Code-Body-Body1">
<td class="TableStyle-Code-BodyA-Column2-Body1"><pre xml:space="preserve" class="TableCell">If ALL of these conditions are TRUE:</pre><pre xml:space="preserve" class="TableCell">SKU is one of D123, E123, F123</pre>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
<p>Use the following formula to determine the correct value for the Maximum Qty Discount:</p>
<ul class="TableInBody">
<li class="NoBullet" value="1">
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/Code.css');margin-left: 0;margin-right: auto;" class="TableStyle-Code" cellspacing="0">
<col class="TableStyle-Code-Column-Column2" style="width: 100%;" />
<tbody>
<tr class="TableStyle-Code-Body-Body1">
<td class="TableStyle-Code-BodyA-Column2-Body1"><pre xml:space="preserve" class="TableCell">Formula = (X+Y) * (M/Y)</pre><pre xml:space="preserve" class="TableCell">Where</pre><pre xml:space="preserve" class="TableCell">X = number of items purchased</pre><pre xml:space="preserve" class="TableCell">Y = number of free items</pre><pre xml:space="preserve" class="TableCell">M = Maximum number of free items allowed</pre>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
<p>For example:</p>
<ul class="TableInBody">
<li class="NoBullet" value="1">
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/Code.css');margin-left: 0;margin-right: auto;" class="TableStyle-Code" cellspacing="0">
<col class="TableStyle-Code-Column-Column2" style="width: 100%;" />
<tbody>
<tr class="TableStyle-Code-Body-Body1">
<td class="TableStyle-Code-BodyA-Column2-Body1"><pre xml:space="preserve" class="TableCell">Buy 5 Get 2 Free with maximum of 4 free items allowed.</pre><pre xml:space="preserve" class="TableCell">Where</pre><pre xml:space="preserve" class="TableCell">X = 5</pre><pre xml:space="preserve" class="TableCell">Y = 2</pre><pre xml:space="preserve" class="TableCell">M = 4</pre><pre xml:space="preserve" class="TableCell">Maximum Qty Discount = (5+2)*(4/2)=(7)*(2)=14</pre>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
<ul class="TableInBody">
<li class="NoBullet" value="1">
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/Code.css');margin-left: 0;margin-right: auto;" class="TableStyle-Code" cellspacing="0">
<col class="TableStyle-Code-Column-Column2" style="width: 100%;" />
<tbody>
<tr class="TableStyle-Code-Body-Body1">
<td class="TableStyle-Code-BodyA-Column2-Body1"><pre xml:space="preserve" class="TableCell">Buy 5 Get 3 Free with maximum of 9 free items allowed.</pre><pre xml:space="preserve" class="TableCell">Where</pre><pre xml:space="preserve" class="TableCell">X = 5</pre><pre xml:space="preserve" class="TableCell">Y = 3</pre><pre xml:space="preserve" class="TableCell">M = 9</pre><pre xml:space="preserve" class="TableCell">Maximum Qty Discount = (5+3)*(9/3)=24</pre>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
<ul class="TableInBody">
<li class="NoBullet" value="1">
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/Code.css');margin-left: 0;margin-right: auto;" class="TableStyle-Code" cellspacing="0">
<col class="TableStyle-Code-Column-Column2" style="width: 100%;" />
<tbody>
<tr class="TableStyle-Code-Body-Body1">
<td class="TableStyle-Code-BodyA-Column2-Body1"><pre xml:space="preserve" class="TableCell">Buy 20 Get 2 Free with maximum of 20 free items allowed.</pre><pre xml:space="preserve" class="TableCell">Where</pre><pre xml:space="preserve" class="TableCell">X = 20</pre><pre xml:space="preserve" class="TableCell">Y = 2</pre><pre xml:space="preserve" class="TableCell">M = 20</pre><pre xml:space="preserve" class="TableCell">Maximum Qty Discount = (20+2)*(20/2)=(22)*(10)=220</pre>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
</div>
<div style="padding-top: 58px;">
<div class="miniTOCProxy" style="line-height: 115%; margin-bottom:0px; padding-bottom: 0px;">
</div>
</div>
<div class="footer">
<br style="clear:both;" />
<div class="floatRightFinePrint"><span class="MyVariablesCopyright-short version">Copyright © 2019</span>, <a href="http://magento.com/" target="_blank" title="Magento, Inc." alt="Magento, Inc.">Magento, Inc.</a> All rights reserved. </div>
</div>
</div>
</section><a class="exit-off-canvas"></a>
</section>
</div>
<script>/* <![CDATA[ */$(document).foundation();/* ]]> */</script>
</div>
</body>
</html>