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:
- 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.
- 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:
- 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 Sellers
Starter Pack Algorithms
These algorithms are Unbxd-defined custom/hybrid algorithms with specific observation periods and pre-defined fallbacks.
| Custom Algorithm | Observation Period | Core Algorithm | Fallback |
|---|---|---|---|
| Recommended For You | – | All 18 Slots: Recommended For You | Recently Viewed, Top Sellers |
| Top Sellers | 30 days | All 18 Slots: Top Sellers | Recommended For You, Recently Viewed |
| Top Sellers by location | 30 days | All 18 Slots: Top Sellers | Recommended For You, Recently Viewed |
| Optimize for new Users | 30 days | Slots 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 bought | 30 days | All 18 Slots: Bought Also Bought | Viewed Also Viewed, More Like This |
| Wisdom Of The Crowd – Users also Viewed | 30 days | All 18 Slots: Viewed Also Viewed | Bought Also Bought, More Like This |
| Similar Products (based on category and title) | 30 days | All 18 Slots: More Like This | – |
| Similar products – Bought Also Bought | 30 days | Slots 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 This | Viewed Also Viewed, More Like This |
| Similar products – Viewed Also Viewed | 30 days | Slots 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 This | Bought Also Bought, More Like This |
| Complete The Look | 30 days | All 18 Slots: Complete The Look | – |
| Cross Sell – Similar products | 30 days | All 18 Slots: More Like This | – |
| Cross-sell | 30 days | All 18 Slots: Cross Sell | More Like This |
| Category Top Sellers | 30 days | All 18 Slots: Category Top Sellers | – |
| Category Top Sellers by location | 30 days | All 18 Slots: Category Top Sellers | – |
Functionalities
Search
The Search functionality helps users quickly locate specific custom algorithms by name.
- Click the Search icon located in the top-right corner of the algorithm list view.
- 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.
- Click the Filter icon next to the search icon. A filter panel or drop-down appears with multiple filter options.
- 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.
- Click the three-dot menu (︙) beside the desired algorithm.
- Select Delete Custom Algorithm.
- 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.
- Navigate to the Custom Algorithms tab under Manage Algorithms.
- Locate the algorithm you want to duplicate in the list.
- Click the three-dot menu (︙) on the right side of the algorithm row.
- 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. |
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: |
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. |
- Select Duplicate Custom Algorithm from the dropdown.
Create Custom Algorithm
To create a custom algorithm:
- Click Manage > Algorithms.
- On the Manage Algorithms page, click Custom.
- Click the Create New button. The Create Custom Algorithm page appears.
- Type in a name for the algorithm in the title text field.
- Click the Create an algorithm based on a drop-down box and select the required algorithm.
- 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.
- To create filter rules, click Add within Custom Filter Rules. You can create Dynamic or Static filters.
- 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.
NoteBy default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.
- 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:
- Click Manage > Algorithms.
- On the Manage Algorithms page, click Custom.
- Click the drop-down arrow for the required user-defined algorithm within the Manage Algorithms table.
- Click Preview. The Preview Algorithm page appears.
Depending on the widget, type the User ID, Product ID, or Category ID to view product recommendations.
- Click Preview. To exit, click the X.
- The preview gives you a visual snapshot of the algorithm.
Edit Custom Algorithms
Unbxd allows you to edit and modify user-defined custom algorithms.
- Click Manage > Algorithms.
- On the Manage Algorithms page, click Custom.
- Click the drop-down arrow for the required user-defined algorithm within the Manage Algorithms table.
- Click Edit. The Create Custom Algorithm page appears.
- To edit the title of the algorithm, type in a name in the title text field.
- To edit the algorithm, click the Create an algorithm based on the drop-down box and select the required algorithm.
- To create a hybrid, click Create Hybrid. To know how to create a hybrid algorithm, click here.
- 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.
- 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.
NoteBy default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.
- Click the Save button.
You have successfully edited your custom algorithm.
Delete Custom Algorithms
You can delete user-defined custom algorithms.
NoteAlgorithms once deleted cannot be retrieved.
To Delete
- Click Manage > Algorithms.
- On the Manage Algorithms page, click Custom.
- Click the drop-down arrow for the required user-defined algorithm within the Manage Algorithms table. Click Delete.
- Click Yes, Delete.
You have successfully deleted your custom algorithm.
Duplicate Custom Algorithms
To duplicate:
- Click Manage > Algorithms.
- On the Manage Algorithms page, click Custom.
- Click the drop-down arrow for the required custom algorithm within the Manage Algorithms table.
- Click Duplicate. The Create Custom Algorithm page appears.To edit the title of the algorithm, type in a name in the title text field.
- To edit the algorithm, click the Create an algorithm based on the drop-down box and select the required algorithm.
- To create a hybrid, click Create Hybrid. To know how to create a hybrid algorithm, click here.
- 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.
- 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.
- Click the Save button. You have successfully duplicated a custom algorithm.
Updated 16 days ago
