Skip to content

[Discount] Product guide #2767

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jun 10, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/discounts/discounts.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
---

Check warning on line 1 in docs/discounts/discounts.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/discounts/discounts.md#L1

[Ibexa.ReadingLevel] The grade level is 12.30. Aim for 8th grade or lower by using shorter sentences and words.
Raw output
{"message": "[Ibexa.ReadingLevel] The grade level is 12.30. Aim for 8th grade or lower by using shorter sentences and words.", "location": {"path": "docs/discounts/discounts.md", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}
description: Discounts help store managers reduce prices on products or product categories.
page_type: landing_page
editions:
Expand All @@ -12,7 +12,7 @@
With the Discounts feature, store managers can reduce prices on specific products or categories for all or selected customers.
After you install it, temporary or permanent discounts can be applied against items from the product catalog or cart.

You can also extend the feature, for example by creating custom pricing rules, application conditions, or changing discount priorities.
You can also extend the feature, for example, by creating custom pricing rules, application conditions, or changing discount priorities.

[[= cards([
"discounts/discounts_guide",
Expand Down
13 changes: 7 additions & 6 deletions docs/discounts/discounts_guide.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
---

Check warning on line 1 in docs/discounts/discounts_guide.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/discounts/discounts_guide.md#L1

[Ibexa.ReadingLevel] The grade level is 10.35. Aim for 8th grade or lower by using shorter sentences and words.
Raw output
{"message": "[Ibexa.ReadingLevel] The grade level is 10.35. Aim for 8th grade or lower by using shorter sentences and words.", "location": {"path": "docs/discounts/discounts_guide.md", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}
description: Discounts LTS Update enables reducing prices on products or product categories based on a detailed logic resolution.
month_change: false
editions:
Expand All @@ -8,13 +8,13 @@

# Discounts product guide

## What are Discounts
## What are discounts

Just like brick-and-mortar shops, online stores use clever strategies to attract new customers, keep loyal ones, boost sales, highlight special products, and clear out inventory.

Check warning on line 13 in docs/discounts/discounts_guide.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/discounts/discounts_guide.md#L13

[Ibexa.VerySimply] Avoid using 'Just'.
Raw output
{"message": "[Ibexa.VerySimply] Avoid using 'Just'.", "location": {"path": "docs/discounts/discounts_guide.md", "range": {"start": {"line": 13, "column": 1}}}, "severity": "WARNING"}

One powerful technique that helps achieve these goals is offering discounts.
Discounts allow online stores to temporarily or permanently reduce prices on specific products or categories, making deals more attractive to potential buyers.
They can be used to encourage first-time purchases, reward loyal customers, promote new or slow-moving items, or drive sales during seasonal events.

Check warning on line 17 in docs/discounts/discounts_guide.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/discounts/discounts_guide.md#L17

[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.
Raw output
{"message": "[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.", "location": {"path": "docs/discounts/discounts_guide.md", "range": {"start": {"line": 17, "column": 1}}}, "severity": "WARNING"}
By displaying discounted prices clearly in the catalog or cart, businesses can create a sense of urgency, increase customer satisfaction, and ultimately boost revenue.

[[= product_name =]] can be equipped with the Discounts [LTS update](editions.md#lts-updates) that introduces a highly extensible solution for building discounts.
Expand All @@ -38,9 +38,9 @@
Discounts are an opt-in capability available as an [LTS update](editions.md#lts-updates) starting with the v4.6.19 version of [[= product_name_com =]].
To begin using Discounts, you must first [install the required packages and perform initial configuration](install_discounts.md).

## How it works

Check warning on line 41 in docs/discounts/discounts_guide.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/discounts/discounts_guide.md#L41

[Ibexa.HeadingContent] Rename the heading '## How it works', or re-purpose the content elsewhere.
Raw output
{"message": "[Ibexa.HeadingContent] Rename the heading '## How it works', or re-purpose the content elsewhere.", "location": {"path": "docs/discounts/discounts_guide.md", "range": {"start": {"line": 41, "column": 1}}}, "severity": "WARNING"}

The discount feature hooks into the price resolving logic of products, allowing you to modify it before it's displayed to the customers.
The Discounts feature hooks into the price resolving logic of products, allowing you to modify it before it's displayed to the customers.

### Core concepts

Expand All @@ -50,12 +50,12 @@

Discounts are applied in two places:

- **Catalog discounts** are activated when browsing the product catalog and do not require any action from the customer to be activated
- **Cart discounts** can activate when entering the [cart](cart.md), if the right conditions are met. They may also require entering a discount code to be activated
- **Product catalog** - catalog discounts are activated when browsing the product catalog and do not require any action from the customer to be activated
- **Cart** - cart discounts can activate when entering the [cart](cart.md), if the right conditions are met. They may also require entering a discount code to be activated

A shopping cart can have multiple active discounts, but a specific product can only have a single discount applied to it at a time.

When two or more discounts could be applied to a single product, the system evaluates the following properties to choose the right one:
When two or more discounts can be applied to a single product, the system evaluates the following properties to choose the right one:

- discount activation place (cart discounts rank higher over catalog discounts)
- discount priority (higher priority ranks higher)
Expand Down Expand Up @@ -85,7 +85,8 @@

#### Product selection

All products, including [product variants](pim_guide.md#product-variants), can be selected when creating a discount. You can also limit this choice to a subset of products:
All products, including [product variants](pim_guide.md#product-variants), can be selected when creating a discount.
You can also limit this choice to a subset of products:

- belonging to selected [product categories](pim_guide.md#product-categories)
- hand-picked manually for special cases
Expand Down Expand Up @@ -131,7 +132,7 @@
For example, [[= product_name =]] could apply a special discount when a customer places their 1st, 3rd, or 100th order in the storefront.
This encourages first-time purchases and drives long-term customer loyalty.

## Use cases

Check warning on line 135 in docs/discounts/discounts_guide.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/discounts/discounts_guide.md#L135

[Ibexa.HeadingContent] Rename the heading '## Use cases', or re-purpose the content elsewhere.
Raw output
{"message": "[Ibexa.HeadingContent] Rename the heading '## Use cases', or re-purpose the content elsewhere.", "location": {"path": "docs/discounts/discounts_guide.md", "range": {"start": {"line": 135, "column": 1}}}, "severity": "WARNING"}

Out of the box, the [[= product_name_base =]] Discounts LTS update comes with multiple discount types that can be applied in the following use cases.

Expand Down
Loading