Custom Algorithms

Overview

Custom algorithms are algorithms you create that are based on core algorithms and include filters and fallbacks.

There are two types of Custom Algorithms:

  1. Unbxd-defined: Also known as a Starter Pack, these are a default list of custom algorithms pre-defined by Unbxd. You cannot edit or delete them. You can, however, duplicate them. For the full list of Unbxd-defined custom algorithms and its fallbacks, click here.
  2. User-defined: List of custom algorithms you’ve created. You can edit, delete, and duplicate user-defined algorithms.

Custom Algorithms

Custom Algorithms help you make your own custom widget formats. You can create custom algorithms based on:

  1. Recommended For You
  2. Top Sellers
  3. Bought Also Bought
  4. Viewed Also Viewed
  5. More Like This
  6. Recently Viewed
  7. Complete The Look
  8. Cross-Sell
  9. Category Top Sellers
  10. Brand Top Sellers

Starter Pack Algorithms

These algorithms are Unbxd-defined custom/hybrid algorithms with specific observation periods and pre-defined fallbacks.

Custom AlgorithmObservation PeriodCore AlgorithmFallback
Recommended For YouAll 18 Slots: Recommended For YouRecently Viewed, Top Sellers
Top Sellers30 daysAll 18 Slots: Top SellersRecommended For You, Recently Viewed
Top Sellers by location30 daysAll 18 Slots: Top SellersRecommended For You, Recently Viewed
Optimize for new Users30 daysSlots 1–3: Recently Viewed<br>Slots 4–6: Top Sellers<br>Slots 7–9: Recently Viewed<br>Slots 10–18: Top Sellers
Wisdom Of The Crowd – Users also bought30 daysAll 18 Slots: Bought Also BoughtViewed Also Viewed, More Like This
Wisdom Of The Crowd – Users also Viewed30 daysAll 18 Slots: Viewed Also ViewedBought Also Bought, More Like This
Similar Products (based on category and title)30 daysAll 18 Slots: More Like This
Similar products – Bought Also Bought30 daysSlots 1–3: Bought Also Bought<br>Slots 4–6: More Like This<br>Slots 7–9: Bought Also Bought<br>Slots 10–18: More Like ThisViewed Also Viewed, More Like This
Similar products – Viewed Also Viewed30 daysSlots 1–3: Viewed Also Viewed<br>Slots 4–6: More Like This<br>Slots 7–9: Viewed Also Viewed<br>Slots 10–18: More Like ThisBought Also Bought, More Like This
Complete The Look30 daysAll 18 Slots: Complete The Look
Cross Sell – Similar products30 daysAll 18 Slots: More Like This
Cross-sell30 daysAll 18 Slots: Cross SellMore Like This
Category Top Sellers30 daysAll 18 Slots: Category Top Sellers
Category Top Sellers by location30 daysAll 18 Slots: Category Top Sellers

Functionalities

Search

The Search functionality helps users quickly locate specific custom algorithms by name.

  1. Click the Search icon located in the top-right corner of the algorithm list view.
  2. Enter a keyword or partial algorithm name in the search input field.

The list will automatically update to show matching algorithms.

Filter

The Filter functionality allows users to narrow down the list of custom algorithms based on key metadata.

  1. Click the Filter icon next to the search icon. A filter panel or drop-down appears with multiple filter options.
  2. Select one or more criteria to refine the results. Available Filter Options:
  • Status: Filter by Active or Inactive status.
  • Created By: View algorithms created by a specific user.
  • Date Modified: Limit results by a specific date or date range.

Delete Custom Algorithm

Use this option to permanently remove a custom algorithm from your workspace.

  1. Click the three-dot menu (︙) beside the desired algorithm.
  2. Select Delete Custom Algorithm.
  3. Confirm the deletion when prompted.

The selected algorithm is permanently deleted from the list. This action is irreversible—once deleted, the configuration cannot be recovered.

Duplicate Custom Algorithm

The Duplicate feature allows users to quickly create a copy of an existing custom algorithm, retaining its entire configuration for easy reuse or modification.

  1. Navigate to the Custom Algorithms tab under Manage Algorithms.
  2. Locate the algorithm you want to duplicate in the list.
  3. Click the three-dot menu (︙) on the right side of the algorithm row.
  4. Configure the following sections:

Column Name

Description

Algorithm Name

The unique name assigned to the custom algorithm. This helps identify the algorithm in the listing view. By default, duplicated algorithms are suffixed with “copy 1,” “copy 2,” etc.

Select a base algorithm

Allows you to select the algorithm you want to use for the custom algorithm.
The options available are: Recommended For You, Top Sellers, Bought Also Bought, Viewed Also Viewed, More Like This, Recently Viewed, Complete The Look, Cross-Sell, Category Top Sellers, Brand Top Seller.

Slot Selection

Allows you to indicate the specify the time duration considered by the algorithm to produce the results.

Create Hybrid

Clicking this allows you to merge multiple base algorithms into a hybrid configuration, useful for advanced use cases where combining logics improves performance.

Lookback Period

Sets the time range the algorithm will consider for user behavior or product activity (e.g., past 20 days). Adjustable in units like days or weeks depending on data volume or use case.

Custom Filter Rules

Allows you to set specific filters to refine products that will be displayed within the widget. You can create two types of filters:
Dynamic: When the value of the filter is dependant on the anchor product.
Static: When the value of the filter is independent of the anchor product.

Location

When enabled, the recommendations generated by the algorithm are at the city-level

Fallback

Allows you to choose the alternate algorithm which is used to generate results. You can:

Fallback: Indicates the fallback is based on the algorithm you chose in the Create an algorithm based on field. You can specify the base algorithm you want to use and the number of slots for the widget.

Manual Fallback: Indicates the fallback is manual with a static list of products to display.

By default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.

Choose Algorithm (Fallback)

If fallback is set to “Algorithm,” select the algorithm that should be used as a backup recommendation logic.

No of Slots (Fallback)

Specifies how many slots the fallback algorithm should fill if triggered. Use the (+) or (−) buttons to adjust.

  1. Select Duplicate Custom Algorithm from the dropdown.

Create Custom Algorithm

To create a custom algorithm:

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the Create New button. The Create Custom Algorithm page appears.
  4. Type in a name for the algorithm in the title text field.
  5. Click the Create an algorithm based on a drop-down box and select the required algorithm.
  6. To choose the number of slots you want to apply the algorithm on, click the Slots drop-down arrow. By default, the algorithm is applied to all 18 slots.
  7. To create filter rules, click Add within Custom Filter Rules. You can create Dynamic or Static filters.
  8. To enable fallbacks, click the Fallback toggle button. You can choose between:
    • Fallback: Indicates the fallback is based on the algorithm you chose in the Create an algorithm based on field. You can specify the base algorithm you want to use and the number of slots for the widget. To add fallbacks, click Add.
    • Manual Fallback: Indicates the fallback is manual with a static list of products to display.
    📘

    Note

    By default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.

  9. Click the Save button. The new custom algorithm will appear in the Manage Algorithms table. You have successfully created a custom algorithm.

Preview Custom Algorithms

Specific widgets will require specific information to display recommendation previews.

To preview:

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the drop-down arrow for the required user-defined algorithm within the Manage Algorithms table.
  4. Click Preview. The Preview Algorithm page appears.

Depending on the widget, type the User ID, Product ID, or Category ID to view product recommendations.

  1. Click Preview. To exit, click the X.
  2. The preview gives you a visual snapshot of the algorithm.

Edit Custom Algorithms

Unbxd allows you to edit and modify user-defined custom algorithms.

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the drop-down arrow for the required user-defined algorithm within the Manage Algorithms table.
  4. Click Edit. The Create Custom Algorithm page appears.
  5. To edit the title of the algorithm, type in a name in the title text field.
  6. To edit the algorithm, click the Create an algorithm based on the drop-down box and select the required algorithm.
  7. To create a hybrid, click Create Hybrid. To know how to create a hybrid algorithm, click here.
  8. To choose the number of slots you want to apply the algorithm on, click the Slots drop-down arrow. By default, the algorithm is applied to all 18 slots.
  9. To enable fallbacks, click the Fallback toggle button. You can choose between:
    • Fallback: Indicates the fallback is based on the algorithm you chose in the Create an algorithm based on field. You can specify the base algorithm you want to use and the number of slots for the widget. To add fallbacks, click Add.
    • Manual Fallback: Indicates the fallback is manual with a static list of products to display.
    📘

    Note

    By default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.

  10. Click the Save button.

You have successfully edited your custom algorithm.

Delete Custom Algorithms

You can delete user-defined custom algorithms.

📘

Note

Algorithms once deleted cannot be retrieved.

To Delete

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the drop-down arrow for the required user-defined algorithm within the Manage Algorithms table. Click Delete.
  4. Click Yes, Delete.

You have successfully deleted your custom algorithm.

Duplicate Custom Algorithms

To duplicate:

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the drop-down arrow for the required custom algorithm within the Manage Algorithms table.
  4. Click Duplicate. The Create Custom Algorithm page appears.To edit the title of the algorithm, type in a name in the title text field.
  5. To edit the algorithm, click the Create an algorithm based on the drop-down box and select the required algorithm.
  6. To create a hybrid, click Create Hybrid. To know how to create a hybrid algorithm, click here.
  7. To choose the number of slots you want to apply the algorithm on, click the Slots drop-down arrow. By default, the algorithm is applied to all 18 slots.
  8. To enable fallbacks, click the Fallback toggle button. You can choose between:
    • Fallback: Indicates the fallback is based on the algorithm you chose in the Create an algorithm based on field. You can specify the base algorithm you want to use and the number of slots for the widget. To add fallbacks, click Add.
    • Manual Fallback: Indicates the fallback is manual with a static list of products to display.
    📘

    Note:

    By default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.

  9. Click the Save button. You have successfully duplicated a custom algorithm.