The Sale add-on lets you create percentage-based discounts for groups of products—whether it’s a category, subcategory, brand, product class, or a custom selection.
These discounts are called Sale Offers. You can set them to expire, show on a dedicated storefront page, or limit them to specific memberships.
In this guide, we’ll walk you through how Sale Offers work and how to set them up.
When should you use sale offers?
Sale Offers are great for:
Seasonal promotions like a Winter Sale
Discounting specific product types (e.g., all brake pads or a single brand)
Creating a dedicated Sale page to showcase discounted items
They help you boost sales, move older inventory, and draw attention to key products. Use them whenever you want to solve one (or all) of those.
How to create a sale offer for categories, brands, product classes and memberships.
In your X-Cart Admin:
Go to Promotions › Sale Promotions and click New Sale.
Add a name for your offer.
Use the Enabled toggle to turn the sale offer on or off
Enter discount amount as a percentage.
Complete any optional settings you need.
Click Create.
Recalculate quick data after creating a sale offer to ensure that the offer becomes visible in product filters and displays correctly.
 |
|
💡 You can recalculate data not only on the selected sale offer’s page but also for all offers at once from Promotions › Sale Promotions or System tools › Cache management.
Sale optional settings
Each sale offer page lets you customize things like discount amount, schedule, and which product groups the sale applies to.
Below is a list of these settings – click any to learn more!
List sale products in a separate section
List sale products in a separate section
Turn on this toggle to create a dedicated page for your sale offer.
Once enabled, you’ll see extra fields appear to help you set up the page:
Clean URL – a clean, SEO-friendly web address for the sale page. You need to check if Clean URLs are enabled.
Discount page title – set how the sale title should appear on the storefront. Leave blank to use discount name at the top of the page as Page Title.
Meta keywords – Add keywords to help search engines find your sale page.
Meta description – write a short description to show up in search results.
Open Graph meta tags – customize how your sale offer looks when shared on Facebook.
You can also choose to show a link to this page above or below your store’s category list. Just go to the add-on settings to set it up.
Apply sale discount to wholesale prices
Apply sale discount to wholesale prices
Turn this on to include wholesale-priced products in the sale. Discounts must be percentage-based for this to work.
⚠️ Only if you have the Wholesale add-on enabled.
Active from / Active till
Active from / Active till
Sets the start and end dates for the sale offer.
Valid only for specific products
Valid only for specific products
Turn this on to apply the sale only to a custom group of products.
If enabled, the Categories and Product classes options will be hidden.
Categories
Categories
Select one or more categories or subcategories where the discount applies.
Brands
Brands
Select one or more brands to apply the discount to. Only products from these brands will be included in the sale offer.
Product classes
Product classes
Choose the product class(es) that the discount covers.
Memberships
Memberships
Limit the sale offer to certain customer membership levels.
How to edit a sale offer (or change product selection)
In your X-Cart Admin:
Go to Promotions › Sale Promotions.
Click the sale name you want to edit or click Products to update the product list the sale offer applies to.
Make your changes.
Click Update.
Recalculate quick data to apply the changes.
 |
|
How to delete a sale offer
In your X-Cart Admin:
Go to Promotions › Sale Promotions.
Click on the basket to the far right of the sale name.
Click Save changes to apply.
 |
|
Creating a sale offer for a custom selection of products
You can also create discounts for products that don’t fit into a standard category, subcategory, product class, or brand.
To create a custom sale offer in your X-Cart Admin:
Follow the standard sale offer setup steps.
Enable Valid only for specific products toggle.
(Optional) Enable List sale products in a separate section toggle if you want a dedicated sale page for these products.
Click Create.
After saving, you need to choose which products the sale applies to. You can do this in two ways:
Method 1: Use the Products tab on the sale offer page
Method 1: Use the Products tab on the sale offer page
After you create or update your sale offer with the Valid only for specific products toggle enabled, a Products tab will appear on the sale offer page.
Switch to Open the Products tab.
Click Add products to open the product list.
Select the products you want to include.
Click Add products to apply the discount
Method 2: Use the Global discounts field on each product page
Method 2: Use the Global discounts field on each product page
After you create or update your sale offer with the Valid only for specific products toggle enabled, each product’s detail page will have a Global discounts field in the Price & Inventory section.
To add a sale offer to a product this way:
Find the product in your product list and open its details page.
Scroll to the Price & Inventory section.
Click the Global discounts field to see available sale offers.
Select the sale offer(s) you want to apply. You can apply multiple sale offers to one product. The final discount will follow rules for handling multiple discounts.
Click Update product to save.
Admin experience
All products, categories, subcategories, brands, and product classes with an active group sale offer display the sale offer name as a label across various places in the X-Cart Admin.
 |
|
The sale offer names shown as labels on products and categories are clickable links. Clicking a sale offer name takes you to its details page.
Here’s a detailed list showing where each type of sale offer label appears:
For Products:
For Products:
Sale offers listing page (Promotions › Sale Promotions)
Product listing page (Catalog › Products)
Product details page (Catalog › Products › [Product Name] › Info).
Categories and subcategories
Categories and subcategories
Category listing page (Catalog › Categories)
Product listing page (products within those categories/subcategories)
Brands
Brands
Product listing page (products of those brands)
Product classes
Product classes
Product listing page (products within those classes)
💡 If a sale offer expires or is disabled, the label is removed from the product listing page but remains visible in the Global discounts field of the product details page (under Prices & Inventory).
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!
Related articles