The Sale add-on allows configuring discounts for groups of products such as:

  • a group of arbitrarily selected products,

  • a category/subcategory,

  • a product class.

Product group discounts are called sale offers.

A store administrator manages sale offers using the Sale section of the store Admin Area (Discounts > Sale).

In X-Cart Multivendor stores, where vendors have permission to manage sale offers, they can do it in the Sale section of the Vendor Area (Discounts > Sale).

Sale offers can have an expiration period and be displayed in the storefront.

Creating a Sale Offer

To create a sale offer:

  1. In the store's back end (Admin / Vendor), go to the Sale section (Discounts > Sale).

    541-sale-page-admin.png

  2. Click New sale to open the sale offer settings page.

    541-new-sale-page.png

  3. Configure your sale offer by adjusting the following settings:

    • Vendor (available for admin users in Multivendor edition only): A store administrator can use this field to set an owner for the offer (either a store administrator acting as a vendor or any of the vendors). If defined, this setting restricts the sale offer to the products of the specified owner. The owner specified by this setting can edit the offer if they choose to - provided that they have permission to manage sale offers for their products (See Configuring the Sale Add-on for information on the setting "Allow vendors to manage sale discounts for their products"). If the field is left blank, a store administrator can apply the sale offer to any product in the store regardless of the product owner. In this case, only administrator users will be able to manage this offer.

    • Name: The name of the sale offer. This name will display in the store's back end (Admin / Vendor areas) as a label attached to the product names covered by this sale offer.

    • Enabled: Use the toggle to activate/deactivate the sales offer.

    • List sale products in a separate section: Use this toggle to enable a separate page for a sale offer on the site. You can configure the add-on settings to display a link above or below the store's categories list on the storefront (See Configuring the Sale Add-on for information on the "How to display links to sale offers in the category menu" option).


      When enabled, the sale offer configuration form expands, providing additional fields for the sale offer page setup.

      541-sale-products-in-separate-section-yes.png

      • CleanURL: Use this field to specify a human-readable and SEO-friendly web address for the sale page. The default option is an autogenerated Clean URL.
        To use this feature, make sure Clean URLs are enabled in your store as described in Setting up SEO-friendly URLs.

      • Discount page title: Specify the name of the sale offer as it should be displayed on the storefront. If left blank, the name specified in the field "Name" will be used as the name of the sale offer on the storefront.

      • Meta keywords: Specify the keywords to be used in the keywords META tag on the sale offer page (for SEO purposes).

      • Meta description: Specify the description used in the description META tag on the sale offer page (for SEO purposes).

      • Open Graph meta tags: Specify the custom META tags for sharing the sale offer page on Facebook.

    • Discount amount: Set a discount percentage. Absolute values can not be used for group discounts as they may exceed the default product price of some products included in the group.

    • Apply sale discount to wholesale prices (The setting is available only if the Wholesale add-on is enabled): This toggle allows to include products with wholesale prices into an offer. The offer will only be valid for wholesale prices if the discount amount is set in percentages.

    • Active from / Active till: Set the offer validity period.

    • Valid only for specific products: Use the toggle to enable the sale offer for a group of random products. The default value is NO.
      The toggle hides the "Categories" and "Product classes" properties if set to YES.

    • Categories: Use this field to specify the category and subcategory name applicable for discount. You can select more than one category and subcategory at once.

    • Product classes: Use this field to specify the product class(es) the discount applies to.

    • Memberships: Use this field to limit the sale offer based on customer membership levels.

  4. Click Create. The sale offer will be created and added to the list of sale offers on the Sale page.

    541-sales-list.png

After creating a sale offer, re-calculate your store's quick data to ensure that the offer becomes visible in product filters and displays correctly using one of the following ways:

  • Re-calculate quick data button on a Sale listing page

    541-recalculate-quick-data-lisitng.png
  • "Re-calculation of quick data" link on the Sale offer page

    541-recalculate-quick-data-details.png

Both the button and the link will redirect you to the Cache management page of your store's Admin area (System tools > Cache management). On that page, choose to launch the re-calculation of quick data by clicking the Start button opposite the Calculate quick data option.

541-cache-management.png

Note that if you choose to create multiple offers, you can re-calculate quick data for all of them at once.

Sale Offers for Groups of Randomly Selected Products

The Sale add-on provides means for a store admin to create a sale offer for products that do not form a standard X-Cart organizational unit, such as a category, subcategory, or product class. We call this method "creating a sale offer for a group of arbitrarily selected products."

To create a sale offer for a group of arbitrarily selected products, use the general procedure for making a sale offer as described above. Please pay special attention to the following settings:

  • List sale products in a separate section: A group of arbitrarily selected products on sale is probably just the case when you need a unique page on the storefront to tell your customers and store site visitors about the sale offer. You may want to adjust this setting to "Yes." You will need to configure some additional fields (CleanURL, Discount page title, Meta keywords, Meta description, Open Graph meta tags).

    541-sale-products-in-separate-section-yes.png
  • Valid only for specific products: Adjust this setting to "Yes."

    After saving your sale offer with the "Valid only for specific products" property enabled, you will need to specify the products to which the offer needs to be applied.

    To do so, use one of the following methods:

    • Method 1: Using the Products tab of the current sale offer

      The Products tab is automatically added to a sale offer once you save the offer details with the "Valid only for specific products" property enabled. That allows applying the offer to products in bulk.

      To apply an offer to products via the Products tab of the sale offer:

      1. Open the Products tab of the sale offer page:

        541-sale-products-tab.png

      2. Click Add products to see the list of products:

        541-sale-products-add.png

      3. Select the products from the popup:

        541-add-products-popup-1.png

      4. Click Add products to apply the discount to the products selected.

    • Method 2: Using the Global discounts field in the "Price & Inventory" section of a product details page

      The Global discounts field is added to the "Price & Inventory" section of a product details page when at least one sale offer with the "Valid only for specific products" property enabled is created in the store. The Global discounts field allows applying sale offers on a per-product basis. For example, you can use this method to add or delete a product to a product group put on sale.

      To apply a discount to a product via the Global discounts field:

      1. Locate the product you require on the product listing page and open its product details for editing.

        541-locate-product-list.png

      2. Scroll down the page to see the "Price & Inventory" section.

        541-product-details.png

      3. Click inside the Global discounts field to see the sale offers available for the product.

        541-global-discounts.png

      4. Click on the sale offer name to apply it to the product.
        You may apply as many group discounts to one product as necessary. The final discount calculation is done according to the "How to handle multiple sale discounts" setting configuration. (See Configuring the Sale Add-on)

        541-add-global-discount.png

      5. Click Update product to save the changes.

All products that have a group sale offer enabled for them will be recorded on the sale offers listing page and labeled with the sale offer name on the product listing and the product details pages in the store's back end.

  • Sale offers listing page

    541-sales-list-products.png
  • Product listing page

    541-product-listing-page.png
  • Product details page

    541-products-details-prices-inventory.png

If a sale offer has expired or is disabled on the Sale page of the store Admin area, its label is not displayed on the product listing page but remains in the Global discount field of the "Prices & Inventory" section on the product details page.

Sale Offers for Product Categories, Subcategories, and Product Classes

The add-on "Sale" makes it possible to create sale offers based on specific product categories/subcategories and product classes.

To create a sale offer for a product (sub)category and product class, use the general procedure of a sale offer creation described above. Please pay special attention to the following settings:

  • List sale products in a separate section: Disable the setting when creating a sale offer for a single category or subcategory. (Obviously, the category/subcategory already has a separate page on the storefront).

    When creating a sale offer for multiple categories/subcategories or a product class, enable the setting. In this case, you will need to adjust some additional fields for the sale offer page configuration (CleanURL, Discount page title, Meta keywords, Meta description, Open Graph meta tags).

    541-sale-products-in-separate-section-yes.png
  • Valid only for specific products: This setting needs to be adjusted to No.

  • Categories: Use this field to specify the categories and subcategories applicable for the sale offer. The offer will apply to every product within the selected category.

  • Product classes: Use this field to specify the product classes to which the offer needs to apply. The offer will apply to every product within the specified product class.

In your store's back end, the sale offers active for specific categories and subcategories display:

  • on category listing pages - as labels attached to the names of categories/subcategories to which they apply;

  • on product listing pages - as labels attached to the names of products from the respective categories/subcategories.

The sale offers active for specific product classes are shown on product listing pages - as labels attached to the names of products from the respective product classes.

  • Category listing page

    541-category-listing-page.png
  • Product listing page

    541-product-listing-classes-categories.png

The sale offer names that appear as labels attached to a product, and category/subcategory names are links. By clicking on a sale offer name link, you can access the respective sale offer details page.


Related pages:

Did this answer your question?