Managing Promotions

This manual explains how to install, configure, and manage promotions in the admin area of your website. Promotions allow you to control pricing rules, discounts, special offers, and marketing conditions across products, categories, and shopping carts.

1) Install the Promotions Module

1. Log in to the admin area of your website.

2. Navigate to the App Shop and Store tabs.

3. Use Quick search to find the Promotions module.

4. Install the module on your website.

Also, see

• Adding Paid Module from Admin Area
• Adding Paid Module from oscommerce.com Account

2) Open the Promotions Management Page

1. Go to Marketing tools → Promotions → Prices.

2. The Promotions management page will open, displaying existing promotions (if any) and configuration options.

3) Configure General Promotion Settings

1. In the Settings section, select how promotions should be applied:

• Base price only
• Inventory price only
• Base and inventory prices

2. Enable or disable the following options as required:

• Use Icon if special is active
• Use Product Properties in Promotions
• Only active products in tree

4) Manage Promotions List

1. Use the corresponding buttons to add, edit, or delete promotions.

2. Set promotion priority by dragging promotions up or down:

• Promotions higher in the list have higher priority.

3. For existing promotions, review:

• Promotion Label and Description
• Status
• Allow other
• Start and End dates
• Promotion Items

4. Use the Filter section to search promotions by sales channel or status.

5) Price Application Logic (Base vs Inventory)

Promotions can differentiate between base and inventory prices for products with attributes.

Example scenario: the base price for a smartphone in black is $100 but for its attribute in red the inventory price is the additional $10 so the smartphone in red costs $110.

If we apply 50% promotion to base price only, the smartphone in black will cost $50 and the smartphone in red will cost $60 (the base price is divided into halves - $50 and the same inventory price is added to the half of the base price $50 + $10 = $60).

If we apply 50% promotion to inventory price only, the smartphone in black will cost $100 and the smartphone in red will cost $105 (the inventory price is divided into halves - $5 and the same base price is added to the half of the inventory price $100 + $5 = $105).

If we apply 50% promotion to both base and inventory prices the smartphone in black will cost $50 and the smartphone in red will cost $55 (the base price is divided into halves - $50 and the inventory price is divided into halves - $5 so half of the base price is added to the half of the inventory price $50 + $5 = $55).

6) Add a New Promotion

1. Click Add new.

2. Select the required promotion type from the drop-down list.

3. You will be redirected to the corresponding promotion settings page.

7) Special Price on Categories / Brands (Salemaker)

7.1 Main Details Configuration

1. Enable or disable:

• Status
• Allow other promotions
• Hide on dependent products

2. Enter:

• Promotion Label
• Promotion Description

3. Enable Show label on front end if required.

4. Set start and end dates.

5. Choose Main products stock indication.

6. Select Main, Advanced, or Basic groups.

7. Enter a value in the Sale field and select:

• Discount
• Percent
• New price

8. Configure Condition options:

• Ignore special price
• Ignore sale condition
• Apply sale condition to special price

9. Set:

• Order limit
• Minimum quantity

10. Enable or disable Disable Purchase function.

11. Assign categories or manufacturers.

Note:

Regarding Discount, Percent or New Price, these options work in the following way.

Discount – it makes a certain discount in some value, for example $50 (if the price is $200 it will be $150 after this promotion is applied).

Percent – it makes a certain discount in percent, for example 50% (if the price is $200 it will be $100 after this promotion is applied).

New Price – it completely replaces the price to the price that is indicated in Sale field regardless what price was applied before.

Regarding Ignore special price, Ignore Sale condition or Apply Sale Condition to Special Price, these options work as follows.

Ignore special price – if a product already has a special price then this special price is ignored and the promotion is applied to the base price only (for example a product base price is $100, its special price is $80 and we have this promotion as 50% discount, so the price of this product will be $50 (the promotion is applied to its base price $100, not to its special price $80))

Ignore Sale condition – the promotion will be ignored for the products that already have discounts.

Apply Sale Condition to Special Price - if a product already has a special price then this special price is taken into account and the promotion is applied to the special price (for example a product base price is $100, its special price is $80 and we have this promotion as 50% discount, so the price of this product will be $40 (the promotion is applied to its special price $80))

7.2 Additional Options

1. Select an icon. You can either choose existing icons from the gallery, or drop files or upload them.

2. Configure font and background colors.

3. Set up promo codes:

• Enter manually or generate automatically
• Define usage limits and customer limits

4. Use the Assign/Restrict tab to link promotions to sales channels and work with other settings as described for the Main details tab.

8) Discount from Shopping Cart Promotion

1. Configure settings similar to Salemaker promotions.

2. Assign main products and dependent products:

• choose a category or a product by clicking on it, and then on >> icon. A category or a product will appear in the right section. If you click on the Main tab and set up buying minimum products quantity for this item, it will affect the chosen item under the Depended tab (if a customer buys minimum products quantity of an item under the Main tab, the Discount from Shopping Cart promotion will be applied to an item under the Depended tab)

3. Optional settings:

• Automatically add product to basket
• Restrict product quantity in basket by item limit

Note:

This promotion appears only in the shopping cart, not on product pages. When you put the goods in the shopping cart, you will see the promotion in it, and the goods will be purchased with this promotion applied.

4. Additional Options

• Select an icon. You can either choose existing icons from the gallery, or drop files or upload them.
• Configure font and background colors.

• Set up promo codes:
  • Enter manually or generate automatically
  • Define usage limits and customer limits

• Use the Assign/Restrict tab to link promotions to sales channels and work with other settings as described for the Main details tab.

9) Multi Discount Promotion

1. Enable promotion and set basic details.

2. Assign products or categories.

3. Define:

• Quantity
• Total amount
• Discount

If a customer purchases products from this category and the amount in the Total amount field is reached by this purchase, the discount indicated in the Discount field will be applied.

4. Apply discounts to:

• Individual items
• Groups of items

To apply this promotion to a group of items, check the boxes next to the required items. The Group button will appear. Click this button to set up this promotion to a group of items (in the same way as it is done for an individual item).

5. Group or ungroup items as needed.

To ungroup the grouped items check the box next to a group. The Ungroup button will appear. Click it to ungroup the items.

6. Configure icons and colors as described earlier.

7. Set up promo codes:

• Enter manually or generate automatically
• Define usage limits and customer limits

8. Use the Assign/Restrict tab to link promotions to sales channels and work with other settings as described for the Main details tab.

10) Discount on Each Quantity Step in Shopping Cart

1. Set promotion status and visibility.

2. Configure discount percentage:

• put a value in the Sale field, and make this value a percent by clicking on the radio buttons in the Type section

3. Set promotion condition:

• ignore special price, ignore sale condition or apply sale condition to special price by clicking on the radio buttons in the Condition section

4. Assign applicable products or categories:

• choose a category or a product by clicking on it, and then on >> icon. A category or a product will appear in the right section

5. Define quantity step (e.g., every 2nd or 3rd product).

• fill in the Qty field (depending on the number (step) indicated in this field, the promotion will be applied.

For example, each second or each third product and so on will be purchased with this promotion).

6. Configure icons, promo codes, and sales channels.

11) Personal Gift on Purchase Promotion

1. Configure main settings similar to Salemaker promotions.

2. Select gift product or category.

3. Define:

• Quantity
• Order total threshold

4. Configure optional settings:

• Skip order history
• Use Exclusive VAT mode

5. Assign icons, promo codes, and sales channels.

12) Free Shipping Conditions Promotion

1. Configure main settings similar to Salemaker promotions.

2. Define conditions based on:

• Products or categories
• Manufacturers
• Countries
• Geo zones

3. Configure icons and promo codes.

4. Assign the promotion to sales channels.

13) Promo Skeleton (HomeFish) Promotion

1. Configure main settings similar to Salemaker promotions.

2. Customize stock indication.

3. Enable Allow other promotions.

4. Choose restriction mode:

• Specify restriction
• Apply on new arrivals
• Apply on sales

If the switch is off for these 3 options choose a category/product by clicking on it, and then click on >> icon.

A category or a product will appear in the right section. If you choose Apply On Sales option, you can also choose Show icon only, Percent discount and Discount option.

Note: For this promotion the following settings should be applied.

1. Allow other option should be switched on.
2. The Main products Stock indication field should be left blank for the system to pick up the real stock from a product.
3. The Promo code field should be left blank as well.
4. Code and description should be added to the Description field.

5. Configure icons, promo codes (if required), and sales channels.

Promotions provide flexible pricing control across your store, allowing you to combine discounts, conditions, and visual indicators to match your marketing strategy. Proper priority management and testing are recommended to ensure promotions behave as expected.