FR
FR Contact us

User guide

Getting started

With Sales Genius, you can offer personalized pricing, private sales, promotions, and bulk discounts to specific customers and markets.

Installing the app

  1. Go to the Shopify App Store

  2. Install the app

  3. Access it through the Apps section of your Shopify Store

Subscription plan

Basic

$10

includes

  • Unlimited product discounts
  • Unlimited catalog discounts
  • Up to 1 segment and 1 market

Advanced

$45

includes

  • Unlimited product discounts
  • Unlimited catalog discounts
  • Up to 10 segments and 10 markets

Premium

$75

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)
  • Basic

    $10

    includes

    • Unlimited product discounts
    • Unlimited catalog discounts
    • Up to 1 segment and 1 market
  • Advanced

    $45

    includes

    • Unlimited product discounts
    • Unlimited catalog discounts
    • Up to 10 segments and 10 markets
  • Premium

    $75

    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."

  1. Select the entire snippet and copy the selection

  2. Click on Edit the snippet

  3. You will be redirected to the price.liquid page for code editing. Paste the snippet just before the start of the HTML code

  4. Click on Save in the upper right corner

  5. 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.

  1. Click on Embed the app. You will be redirected to the customization page for  your theme

  2. In the app embeds side panel, click on the toggle switch next to Sales Genius

  3. Click on Save

  4. 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.

  1. Go to Configuration

  2. In the General section, tick the box Enable the custom prices on the shop

  3. 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:

  1. Click on Create a catalog discount

  2. Define a name and set its priority

  3. Choose the type of discount to apply and specify its value

  4. Enter the start and end dates

  5. Decide whether the promotion will be available to all customers or only to logged-in users.

  6. Select the segments, markets, and collections

  7. In the Magic Link section, check the box to apply the discount only when customers use the secret URL

  8. Click Generate a random code to create a unique secret code, or enter one manually

  9. Select the page where customers will be directed when using the magic link

  10. 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:

  1. Click on Create a product discount

  2. Click on Select a product to choose the product or product variant for the discount

  3. Associate the discount with a specific group for better organization and define its priority

  4. Choose the type of discount and its value

  5. Enter the start and end dates

  6. Choose whether all customers or only logged-in customers will have access to the discount

  7. Select the segments and markets

  8. 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:

  1. Click on New cart discounts - Free gift -

  2. Define a name for the discount

  3. Enter a minimum and maximum for the cart amount

  4. Select the gift product and the quantity

  5. 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:

  • The sample file: a pre-filled file with example data.

  • The catalog file: this file contains all your products from the catalog.

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 and file out the file

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:

  1. Go to Products

  2. Select the product you want to apply custom prices and go to the product page

  3. 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:

  1. Go to Products

  2. Select the product you want to apply custom prices

  3. In the Inventory section, copy the SKU

  4.  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:

  1. Go to CustomersSegments

  2. Click Create segment

  3. Apply criteria and click Save segment

  4. 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:

  1. Go to SettingsMarkets

  2. Click Add market

  3. Enter a name for the market and select a country in the list

  4. 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.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31ABSOLUTE_AMOUNT99.99


Amount on the original price
The AMOUNT_COMPARE_AT_PRICE discount subtracts the value defined in your discount from the original price.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31AMOUNT_COMPARE_AT_PRICE99.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.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31AMOUNT_PRICE99.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.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31PERCENTAGE_COMPARE_AT_PRICE10%


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.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31PERCENTAGE_PRICE10%

Value

The value entered in the value column of your file when creating your discount.
The value can be either

  • a number in the currency of the market in question

  • or a percentage to apply

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.

  1. Go to Import product discounts

  2. 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.

  1. Go to Import product discounts

  2. In the dropdown menu, select the discounts set you want to update

Importing the file

To import your file:

  1. Go to Import product discounts

  2. Click Add file and select your file

  3. 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:

  • The date of the import

  • The name of the promotion set

  • The number of items updated

  • The status of the import

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:

  • The line with the error

  • The ID or SKU of the product

  • The source of the error

Testing discounts

Once imported, you can check the discounts applied to one product using its SKU or ID.

  1. Go to Test discounts

  2. Enter the SKU or the ID of your product

  3. Choose the country in which you want the rules of your product to be tested

  4. 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

  5. Type the date or use the calendar to select the date you want to test your product

  6. If needed, select a secret code

  7. 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.

In the case of a catalog promotion, select the secret code corresponding to that promotion.

Discounts information

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.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31ABSOLUTE_AMOUNT99.99


Amount on the original price

The AMOUNT_COMPARE_AT_PRICE discount subtracts the value defined in your discount from the original price.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31AMOUNT_COMPARE_AT_PRICE99.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.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31AMOUNT_PRICE99.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.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31PERCENTAGE_COMPARE_AT_PRICE10%

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.

SKUTitleSegmentMarketFrom dateTo dateTypeValue
SKU123Private SalesVIPFR2024-04-012025-05-31PERCENTAGE_PRICE10%

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. 

Comment

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.

You can search for a rule, a ruleset or a product with the search bar.

  1. Go to All discounts

  2. Click on the magnifying glass

  3. Enter your search

Add a search filter as a view

  1. Go to All discounts

  2. Click on the magnifying glass

  3. Enter your search

  4. Click Save as

  5. 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

Information

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.

Get the app!

Try now!

What we do

Discover our other apps!

Explore all our solutions to sell more and to get the most of your e-commerce

Contact us

Testimonials

They are happy with us

  • Great

    Easy and painless feed creation, excellent support that quickly helped us create multiple feed templates. Would recommend to anyone needing to create multiple data feeds.

    Super Scientific Direct

    USA

  • Thanks

    Great and swift support, best and most useful app for creating live feeds of all your Shopify data. Thanks!

    Mikono - Jacken aus Kenia

    Allemagne

  • Perfect

    We use this app in almost every of our projects, it works perfectly for any custom feed you need.

    Cinetic

    Spain

  • Adaptative

    This is the most flexible tool to create all kinds of feeds. All business customers require different layouts and fields, and we managed to create all of them.

    Bart - Ferm

    Netherlands

  • Great

    Is a great app and save me many many hours.

    Rui Guedes - Developer

    Portugal