Apply rule boxes based on conditions

Go to Dataflow or Data View from your site's main menu.

Select Rule box conditions in the top ribbon.

In Dataflow, you can find the button here:

In Data View, you can find the button here:

Choose where you want to create a condition in Stage:

1. To apply a condition to an attribute at the intermediate stage, select Intermediate.

2. To apply a condition to an attribute at the export stage, select Export.

Select Add a condition, give it a name and description as desired, and select Create.

When the platform creates your condition, you can see its description by hovering over the condition name. You can also see the description when you apply a condition to an attribute. See Step 5.

To start configuring your condition, set up the IF condition statement first:

1. In Type to search columns, search for and select an attribute that the platform should scan for values.

2. In the contains drop-down list, select the operator that the platform should use to see if the values of the selected attribute meet a desired condition:

   Standard operators:

   • contains applies rule boxes if the selected attribute contains the provided value. This is the default option.

   • not contains applies rule boxes if the selected attribute doesn't contain the provided value.

   • equals applies rule boxes if a value in the selected attribute completely matches the provided value.

   • is not equal to applies rule boxes if a value in the selected attribute doesn't completely match the provided value.

   • like applies rule boxes if a value in the selected attribute matches a pattern. You can use regex to define a pattern.

     For example, you want to apply the rule box Append/Prepend Value to the title attribute if the value in the description attribute starts with This product and ends with green. You can use the like operator with the entry This product%green:

     

     Once you apply the created rule box condition to the title attribute, it changes the values in the title attribute as shown:

     description	title (before)	title (after)
     This product is available in cosmo black and grass green	10" Tablet	10" Tablet. SALE
     This product is available in cosmo black	7" Tablet	7" Tablet

     Since the first product starts and ends with the needed text, the site appends . SALE at the end of its title. The title of the second product remains unchanged because its description ends in black instead of green.

   • not like applies rule boxes if a value in the selected attribute doesn't match a pattern. You can use regex to define a pattern.

   • greater than applies rule boxes if a value in the selected attribute is greater than the provided value.

   • greater than or equal to applies rule boxes if a value in the selected attribute is greater than or equal to the provided value.

   • less than applies rule boxes if a value in the selected attribute is less than the provided value.

   • less than or equal to applies rule boxes if a value in the selected attribute is less than or equal to the provided value.

   • is empty applies rule boxes if the selected attribute contains an empty value.

   • is not empty applies rule boxes if the selected attribute doesn't contain an empty value.

   List operators:

   Note

   To use list operators, you must first create at least one inclusion or exclusion list in your site. See Exclude products with the Standard Inclusion/Exclusion list.

   • contains any of applies rule boxes if a value in the selected attribute contains at least one of the values present in the chosen list.

   • not contains any of applies rule boxes if a value in the selected attribute doesn't contain at least one of the values present in the chosen list.

3. All operators except is empty and is not empty require additional input, such as a static value, an attribute with dynamic values, or a list.

   Choose the suitable option:

   1. To use a static value, enter the value in Type to start.

   2. To use dynamic values, select the toggle Use an attribute and then choose the needed attribute in the field Type to search columns next to it.

   3. To use a list, select the needed list in Type to search lists.

If you want a more elaborate set of condition statements, you can select the plus icon to add more condition statements and set them up as described in Step 5.

IF and AND condition statements can have multiple OR condition statements.

1. Choose AND to let the platform apply rule boxes if both IF and AND condition statements are true. You can add an AND condition statement only from an IF or another AND condition statement.

2. Choose OR to add more options to the existing IF and AND condition statements.

In THEN, choose Select an Option to add and set up the rule boxes you want the platform to apply to your data if your conditions statements are true.

See Find the needed rule box category to find a document about the needed rule box type.

Optionally, in ELSE, you can choose Select an Option to add and set up the rule boxes you want the platform to apply to your data if your condition statements are false.

You can leave the ELSE panel empty and skip adding any rule boxes there. Rule box conditions can work without ELSE rule boxes.

When your condition statements and rule box setups are ready, select Save changes in the top-right corner.

See the following section to proceed.

Go to Dataflow or Data View from your site's main menu.

Open the Edit menu:

In the Edit panel on the right, choose Select an Option.

In the Conditions section, select your desired condition and choose Save.

If the attribute where you added a condition has other conditions or rule boxes, you can drag and drop the new condition to a desired place. This way, you can arrange the order of data optimizations in this attribute.

The order of the applied rule boxes and rule box conditions determines the order of data transformations. The site applies rule boxes and rule box conditions one by one from top to bottom. If you change the order, your resulting attribute value may also change.

If you want to check the settings of an added condition, select Go to condition.

Go to Dataflow or Data View from your site's main menu.

Select Rule box conditions in the top ribbon.

In Dataflow, you can find the button here:

In Data View, you can find the button here:

In Stage, choose the stage where you want to change a condition.

Change the desired settings of a condition by adding, editing, or removing condition statements and rule boxes. See Create a rule box condition to do so.

To remove a condition statement, select the trash icon next to it and then select Delete.

To remove a rule box, select the wrench icon and then select the trash icon .

Tip

If you accidentally deleted all condition statements, you can add a new IF condition statement by selecting Add a condition statement.

When finished, select Save changes.

Go to Dataflow or Data View from your site's main menu.

Select Rule box conditions in the top ribbon.

In Dataflow, you can find the button here:

In Data View, you can find the button here:

In Stage, choose the stage where you want to delete a condition.

Select the trash icon next to the name of the condition you want to delete and confirm the action by choosing Delete.