Getting started
With Sales Genius, you can offer personalized pricing, private sales, promotions, and bulk discounts to specific customers and markets.
Installing the app
Go to the Shopify App Store
Install the app
Access it through the Apps section of your Shopify Store
Subscription plan
includes
- Unlimited product discounts
- Unlimited catalog discounts
- Up to 1 segment and 1 market
includes
- Unlimited product discounts
- Unlimited catalog discounts
- Up to 10 segments and 10 markets
includes
- Unlimited product discounts
- Unlimited catalog discounts
- Cart discounts: «Free gift»
- Unlimited segment and markets
- Access to the JS API for developers (for UX customizations)
-
includes
- Unlimited product discounts
- Unlimited catalog discounts
- Up to 1 segment and 1 market
-
includes
- Unlimited product discounts
- Unlimited catalog discounts
- Up to 10 segments and 10 markets
-
includes
- Unlimited product discounts
- Unlimited catalog discounts
- Cart discounts: «Free gift»
- Unlimited segment and markets
- Access to the JS API for developers (for UX customizations)
Use our get-started tutorials
Once the Setup Wizard steps are completed, head over to the Getting started tab and follow the mini-tutorials to explore Sales Genius.
Setting up the app with the Setup Wizard
The setup wizard assists you in integrating the app by performing all the necessary checks for the application's proper functioning and guiding you through any tasks that need to be completed in the Shopify back office.
Choose the theme on which to run the installation
You need to choose to run the installation on one of three themes based on the style of your store.
It is recommended to create a test theme that is a copy of your main theme. Ensure that everything works correctly on this test theme before publishing it. This allows you to verify that all modifications and functionalities are operational without affecting your live site.
Discounts
In order for discounts to be applied in the cart and at checkout, Sales Genius must create discounts.
When the Setup Wizard is launched, the discounts will be automatically created.
For Sales Genius to work correctly, it is necessary not to delete the 5 discounts created by the app. If you accidentally delete or disable the discounts, the Setup Wizard can recreate them.
To do this, simply click on Check Again at the end of the Setup Wizard
Your discounts are automatically created or activated
Update assets
To apply product promotions, the Liquid snippets must be added to your theme.
The 'green folder' icon indicates that the asset is up to date and no action is required.
The 'blue folder' icon indicates that the asset is missing and will be added.
By clicking on Install/Update assets, they are automatically added.
Modify the price.liquid snippet
To display promotions on your product and collection pages, you must also modify the price.liquid snippet. You will need to manually add the code snippet.
Before you begin, ensure that the status of this step is "awaiting your action."
Select the entire snippet and copy the selection
Click on Edit the snippet
You will be redirected to the price.liquid page for code editing. Paste the snippet just before the start of the HTML code
Click on Save in the upper right corner
Return to the installation assistant and click on Check Again
The status of the step is now Completed
Le code HTML est écrit à l'aide de balises placées entre crochets (< >), tandis que le code Liquid est écrit à l'aide de balises placées entre crochets et de signes de pourcentage ({% % }).
It may happen that the price.liquid file is not found. In this case, the step will be marked as failed.
To add the snippet, locate the folder that contains price.liquid and paste the snippet.
Embed the app
The last step of the Setup Wizard is to add the app to your theme so it can be displayed in your store.
Click on Embed the app. You will be redirected to the customization page for your theme
In the app embeds side panel, click on the toggle switch next to Sales Genius
Click on Save
Go back to the Setup Wizard and click on Check again
The status of the step is now completed.
You have now completed the installation of Sales Genius, and you can start creating your first promotion!
Enabling Sales Genius on the shop
To apply the custom prices on the products in the product, collection, cart and checkout pages, you need to enable the custom prices.
Go to Configuration
In the General section, tick the box Enable the custom prices on the shop
Click Save
Custom prices are now displayed on your store!
Create discounts
There are 3 types of discounts:
Catalog: the discount applies to one/multiple collections or the entire catalog
Product: the discount applies to a selected set of products
Cart: the discount is applied directly in the cart and/or at checkout
Free gift: a product is offered when the cart total falls within a predefined amount range
Buy X, get Y free: coming soon
Free shipping: coming soon
Catalog discounts
In the tab All discountscatalog discounts you can create a new catalog discount that will apply to an entire selected collection. To do this:
Click on Create a catalog discount
Define a name and set its priority
Choose the type of discount to apply and specify its value
Enter the start and end dates
Decide whether the promotion will be available to all customers or only to logged-in users.
Select the segments, markets, and collections
In the Magic Link section, check the box to apply the discount only when customers use the secret URL
Click Generate a random code to create a unique secret code, or enter one manually
Select the page where customers will be directed when using the magic link
Click Save at the top of the page
Your new catalog discount is now visible in the table, and you can access the selected details. From this table, you can modify or delete the discount. For those with a magic link, you can obtain the link by clicking on the copy to clipboard icon.
Product discounts
In the tab All discountsProduct discounts it is possible to create a new product discount that will apply to a specific product or product variant. To do this:
Click on Create a product discount
Click on Select a product to choose the product or product variant for the discount
Associate the discount with a specific group for better organization and define its priority
Choose the type of discount and its value
Enter the start and end dates
Choose whether all customers or only logged-in customers will have access to the discount
Select the segments and markets
Click on Save at the top of the page
Your new product discount is now visible in the table. You have access to the chosen information. From this table, you can modify or delete the discount.
Cart discounts - free gift -
In the tab All discountsCart discounts - free gift - it is possible to create a gift product in the cart based on a defined amount. To do this:
Click on New cart discounts - Free gift -
Define a name for the discount
Enter a minimum and maximum for the cart amount
Select the gift product and the quantity
Click on Save at the top of the page
Your new cart discount is now visible in the table. You have access to the chosen information. From this table, you can modify or delete the discount.
When the cart is between 100€ and 1000€, the free product is added to the cart.
Importing discounts
Importing promotions allows you to set up multiple discounts in a single operation using a pre-filled file that applies the settings in bulk.
Downloading the file
Two different files can be downloaded from the Import Promotions tab:
Download the file you need and open it with a spreadsheet program (Excel), a code editor (VS Code), or Notepad to edit it.
Once you downloaded the file, simply use either a spreadsheet application (Excel), a code editor (VS Code) or Windows’ NotePad to edit it.
Format
Before filling out the file, you must configure the format of the file that will be used during imports.
This configuration also allows you to download sample files with the appropriate formatting.
To do this, in the Import product discounts tab, click on Import file format
On this new page, choose:
The column separator
The text delimiter
The date format
If your file does not comply with the formatting you have configured, it will not be imported and will be marked as "failed."
Fill out the file
You will need to provide the following information about your promotions in the file:
↪ ID
The id of a product is the unique identifier assigned to a variant product.
To know the ID of a product of your store:
Go to Products
Select the product you want to apply custom prices and go to the product page
In the URL, select the numbers after /products/
↪ SKU
The SKU (stock keeping unit) is a unique alphanumeric code of a product.
If you don’t have the id of the product, you can fill in the SKU.
To know the SKU of a product of your store:
Go to Products
Select the product you want to apply custom prices
In the Inventory section, copy the SKU
Paste the SKU in the SKU column of the file
↪ Title
The title section corresponds to the name you want to give to your discount.
In the title column of the file, type the name. If you don’t write any name for a discount, the name of the discounts set will be used.
↪ Priority
The priority of the discount refers to the order in which that discount will be applied.
When two different discounts apply on the same product and have the same priority, the one with the highest promotion, resulting in the lowest price, will apply in priority.
the highest priority is 1
↪ Segment
The segment section refers to a group of customers that meet specific criteria of filters determined by the merchant.
To create a customer segment on your store:
Go to CustomersSegments
Click Create segment
Apply criteria and click Save segment
Choose a name for the segment and click Save
To integrate a segment in the csv file, simply enter the name of the segment in the segment column.
↪ Customer
You can choose if you want your discount to apply to all customers or only customers logged in to your store.
↪ Market
You can select the market where the discount will be applied. To create a market:
Go to SettingsMarkets
Click Add market
Enter a name for the market and select a country in the list
Click Add market
To target a market, you have to enter the name you choose for the market in the csv file. To activate a market, there need to be shipping rates added to the market.
↪ From date
Enter the beginning date in the following format: Y-M-D.
↪ To date
Enter the end date in the following format: Y-M-D.
↪ Type
Five different types of discounts can be applied.
Absolute price
The ABSOLUTE_AMOUNT discount replaces the original price by the value defined in your discount in your file.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | ABSOLUTE_AMOUNT | 99.99 |
Amount on the original price
The AMOUNT_COMPARE_AT_PRICE discount subtracts the value defined in your discount from the original price.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | AMOUNT_COMPARE_AT_PRICE | 99.99 |
Amount on the final price
A final price of a product means that a Shopify discount has already been applied to the product.
The AMOUNT_PRICE discount subtracts the value defined in your discount from the final price.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | AMOUNT_PRICE | 99.99 |
Percentage on the original price
The PERCENTAGE_COMPARE_AT_PRICE discount means that the percentage entered as a value applied to the original price.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | PERCENTAGE_COMPARE_AT_PRICE | 10% |
Percentage on the final price
A final price of a product means that a Shopify discount has already been applied to the product.
The PERCENTAGE_PRICE discount means that the percentage entered as a value applied to the final price.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | PERCENTAGE_PRICE | 10% |
↪ Value
The value entered in the value column of your file when creating your discount.
The value can be either
Create or update an existing discounts set
You can either import a new discounts set or update an existing one.
New discounts set
If you are importing a new discounts set, you have to enter a name for the discounts.
Go to Import product discounts
In the left box, select New discounts setand enter the name
Existing discounts set
If you are importing an existing discounts set, you will erase and replace the previous discounts by the new ones you are importing.
Go to Import product discounts
In the dropdown menu, select the discounts set you want to update
Importing the file
To import your file:
Go to Import product discounts
Click Add file and select your file
Click Proceed
View the import
After importing your file, you can view your latest import as well as the last ten imports.
You have access to the following information:
By clicking on the file icon, you can re-download the import file within a 10-day period imposed by Shopify.
The arrow at the beginning of the line contains possible errors from the import. It indicates:
Testing discounts
Once imported, you can check the discounts applied to one product using its SKU or ID.
Go to Test discounts
Enter the SKU or the ID of your product
Choose the country in which you want the rules of your product to be tested
Choose the segment on which you want the rules of your product to be tested
→ Select Not logged in customers if you don’t want to test on any particular segment
Type the date or use the calendar to select the date you want to test your product
If needed, select a secret code
Click on Run the test
You get a preview of your product with a list of rules ranked by priority. The rule’s line applying is in bold green.
The currency displayed is automatically the currency of the selected market.
If no rule is applied to your product, you will get a message “No discount for this product”.
Testing criteria
The Test discounts feature provides testing criteria that allow for precise testing of a product based on the ID, market/customer segment, a specific date, or the secret code.
Product SKU or variant ID
In order to test promotions, it is mandatory to enter either the SKU or the ID of the product you want to test.
The SKU and ID are to identify your product.
Country
In order to test your product you have to choose a country in which price rules are applied.
To test the product on a market involving multiple countries, choose one of the countries part of the market.
Segment
Select a specific segment to which the promotions will be applied. If you don't have a segment or your promotions aren't tied to any segment, you can simply choose the not logged in customers option.
When creating your promotions in your file, if you leave the segment column empty, the not logged in customers option will be applied by default.
Date
Choose the date on which you want to check if promotions apply to the selected product.
Magic link
In the case of a catalog promotion, select the secret code corresponding to that promotion.
When testing a product, a table gathering all the information regarding discounts applied to the tested product is displayed. Each row concerns a discount applied or not to the product.
Status
The status column informs you the status of your product discounts.
There are three possible status:
Your discount is skipped because either the market, segment or date doesn’t correspond to your testing criteria. The column in red is the reason the discount is skipped.
A discount could not be applied for various reasons such as:
Priority (discount with the highest priority is applied)
Market (discount apply on the market on which the product is tested)
Segment (discount apply on the segment on which the product is tested)
Date (discount apply to the date on which the product is tested)
Your discount is applied.
Your discount is skipped because a rule with a higher priority is applied.
Priority
In the Priority column, you will see the priority chosen when creating your discounts in your file. The priority has an impact on the application of your discounts.
The highest priority is 1, it means when assigning a priority 1, your discount will override all other discounts that correspond to the same criterias in terms of segment, market and date.
When two discounts have the same criteria and priorities, the one resulting in the lowest price is applied.
Label
The Label column corresponds to the name assigned to your discount in your file.
Type
The Type column informs you on the type of discount chosen for each discount.
5 different types of discounts exist:
Five different types of discounts can be applied.
↪ Absolute price
The ABSOLUTE_AMOUNT discount replaces the original price by the value defined in your discount in your file.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | ABSOLUTE_AMOUNT | 99.99 |
↪ Amount on the original price
The AMOUNT_COMPARE_AT_PRICE discount subtracts the value defined in your discount from the original price.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | AMOUNT_COMPARE_AT_PRICE | 99.99 |
↪ Amount on the final price
A final price of a product means that a Shopify discount has already been applied to the product.
The AMOUNT_PRICE discount subtracts the value defined in your discount from the final price.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | AMOUNT_PRICE | 99.99 |
↪ Percentage on the original price
The PERCENTAGE_COMPARE_AT_PRICE discount means that the percentage entered as a value applied to the original price.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | PERCENTAGE_COMPARE_AT_PRICE | 10% |
↪ Percentage on the final price
A final price of a product means that a Shopify discount has already been applied to the product.
The PERCENTAGE_PRICE discount means that the percentage entered as a value applied to the final price.
SKU | Title | Segment | Market | From date | To date | Type | Value | SKU123 | Private Sales | VIP | FR | 2024-04-01 | 2025-05-31 | PERCENTAGE_PRICE | 10% |
Magic link
The magic link corresponds to a unique URL that, when used, applies a specific discount to the customer's cart or checkout.
Value
The value entered in the value column of your file when creating your discount.
It can be either in the currency of the market in question or in percentage.
Market
The market(s) relevant to the discount.
Segment
The segment(s) relevant to the discount.
Customer
The customer column indicated the option chosen when creating the discount:
↪ All customers
Every customer will be able to see the discount.
↪ All customers logged in
Only customers logged in will see the discount.
If the customer field in your file is empty, the discount will automatically apply to every customer logged-in or not. You cannot test a discount combining a logged in customer segment and another segment.
start date
The From date field entered in the discount.
End date
The To date field entered in the discount.
Previous price
This row displays the price before the discount.
New price
This row displays the price after the discount.
This row displays if the discount was applied or skipped.
↪ The discount is applied
If the discount is applied, the discount from your discount is displayed in the preview window.
↪ The rule is skipped
Your discount is not applied due to either:
Priority
Market
Segment
Start/End Date
The magic link
Advanced configuration
Enable the debug mode on the frontend
Activating this debug mode allows additional information about the application of promotions to be displayed on the frontend of the site (user interface).
When this option is enabled and the syde_debug parameter is added to the URL of a product page (for example: https://[shop].myshopify.com/products/[product-handle]/syde_debug), two links will appear:
"Show Sales Genius rules applications details": displays the details of the executed promotions
"Show Sales Genius cart attributes update details": provides information on the update of cart attributes
This mode is useful for developers when they need to test promotions or diagnose issues related to the display of discounts.
Update the discounts to apply in the cart via the Javascript API
This option allows you to configure the application of promotions in the cart using the JavaScript API.
Enabling this setting requires technical configuration by a developer. If you want the promotions to be updated dynamically via API calls, please contact us to obtain the corresponding technical guide.
Maximum number of automatic discounts
You can define the maximum number of automatic promotions that the application can activate on the store.
Reducing the number of discounts helps prevent conflicts with other applications using app discounts, but it may limit the number of discounts that apply simultaneously in the cart.
Managing rules
In the All discounts section, you can see all the discounts created or imported.
mass action
Delete discounts
By checking the respective box for each promotion, you can delete them in bulk.
Export discounts
By checking the respective box for each promotion, you select them and can export them in bulk.
Search bar
You can search for a rule, a ruleset or a product with the search bar.
Go to All discounts
Click on the magnifying glass
Enter your search
Add a search filter as a view
Go to All discounts
Click on the magnifying glass
Enter your search
Click Save as
Enter the name of the view and click Save
Your new view is now displayed.
To rename or delete a view, click on the arrow appearing when you select a view.
Grid paging
Use the grid pager at the bottom of the table to navigate between pages.
Sorting criteria
You are able to sort the table according to different criteria by alphabetical or non-alphabetical order:
Rule
Product
Type
Priority
Start
End
In the Rules table, you have access to multiple information about your rules.
Rule
You can see the name of the rules.
The text in the red square corresponds to the title of the rule written in the csv file.
The text in the green square corresponds to the name of the rules set you enter when importing a csv file.
Product
In the product column, you have access to the name of the product as it is in your store.
Priority
You can see the priority of the product. Learn more about the priority here.
Type
The Type column informs you on the type of discount chosen for each rule. Learn more about the discounts here.
Modifier
The modifier refers to the change applied to the base price of the product.
Market
You can view the market on which the rule applies. Learn more about markets here.
Segments
You can view the customer segments on which the rule is applied.
Learn more about markets here.
Start/end
You can view the start date and the end date of the rule’s application.