Skip to main content
All CollectionsSize RecommenderCustom Recommender
Setting Up a Custom Recommender in Kiwi
Setting Up a Custom Recommender in Kiwi
Updated over 3 months ago

The custom recommender allows you to create personalized recommendations based on any logic you choose. This feature helps shops leverage their deep understanding of customer needs and product details to guide customers toward the best purchase decision.

Setting Up a Custom Recommender

You can create custom input fields for users to fill out, then set up logic to generate size recommendations.

  1. Begin by opening the size chart where you want to add the recommender.

  2. Scroll to the bottom on the left side, then click on "Start setting up recommender." This will open the recommender options.

  3. Click on "Custom Recommender", and in the pop-up, select "Create new custom recommender."


    Here’s what you'll see:

    • Name and Recommender Header: The name is for the app, while the header will appear as the recommender’s title.

    • Custom Recommender Preview: A preview of the steps in your custom recommender.

    • Add Recommender Step: A button to add new steps.

    • Editor: Use this editor to configure each step in the recommender.

    • Custom Variables: Define variables to reference later in the custom recommender.

    • Settings: Additional configuration options for your recommender.

Basic Concepts

The custom recommender is made up of recommender steps. When you click on "Add recommender step," you’ll see the following options:

1. Number Input

This creates a number input field for users to input information such as weight, height, or chest measurement. You can also choose a unit, and the app will automatically display a toggle button for the unit.

What it looks like to the user.

2. Select Input

This input step allows users to choose from a list of options. Click "Add new option" to include more options. You can also choose between two display types:

  • Dropdown


  • Radio

  • Slider


Selector condition to display

This allows the select input to show up ONLY when certain conditions are met. For example, you can have a shoe size recommender where it first has a select input for gender (male or female), and then you have 2 select inputs (male sizes, and female sizes). You can set it up so that male size select input only shows up if gender is selected as male.

For example: the condition is set to #1 == "female", so only when the first selector's value is "female" would the female sizes selector show up.

3. Math Result

Use the results from previous inputs to calculate the size. In the Math Result step, you can apply a formula using the values from previous inputs by referencing them with "#1," "#2," etc.

Some examples are if your final size recommendation requires addition or subtraction of different measurements, then using Math results can be useful.

4. Switch Result

Switch results allow you to create size recommendations based on conditions. You can set up IF conditions using JavaScript functions and values from previous steps to recommend the size.

Referencing Values

You can reference values from earlier steps in the recommender by using the black arrows in the preview. For example, use "#1" for the value of the first step, "#2" for the second step, and so on. You can only reference steps that appear before the current one.

IF expressions

You can use any valid javascript functions as well.

Example condition

Meaning

#1 < 10

Result from element 1 is less than 10

#1 < 10 && #2 < 20

Result from element 1 is less than 10 AND result from element 2 is less than 20

#1 < 10 || #2 < 20

Result from element 1 is less than 10 OR result from element 2 is less than 20

#1 == "male"

Result from element 1 is "male". (we use quotation if the result value is not a number)

Did this answer your question?