Malachyte Portal/Recommend

Components

How to create and manage components

Overview

Use Components when you want to apply business rules to the recommendations that appear on your site. You can launch custom strategies from pre-defined templates while controlling:

  • Eligibility: Which products are eligible to appear.
  • Ranking: How products are ordered and prioritized.

Components combine eligibility logic and merchandising controls into a single configurable layer.

How to Create a Component

  1. Go to the Components tab.
  2. Click Create New Component.
  3. Fill out the required fields:
    • Name: Give your component a recognizable title.
    • Description: Internal notes on the component's purpose.
    • Base Strategy: Select your model (e.g., Recommended For You).

Once created, you can add rules to define specific business logic and fine-tune recommendations. See the Adding Rules section for more details.

Manage Components

The Component Table displays all current components.

Component Table Overview:

ColumnDescription
NameA unique name for your component.
DescriptionMore details about the component, i.e. any business rules that are applied.
StatusShows if the component is Active or Inactive.
StrategyThe underlying logic (e.g., Best Sellers, Personalized).
RulesThe number of business rules applied.

Edit Components

Follow these steps to update an existing component:

  1. Locate the component in the Component Table and click Edit.
  2. You can update any of the following parameters:
    • Domains: Change where the carousel is eligible to appear.
    • Base Strategy: Swap the core logic (e.g., switch from "Trending" to "New Arrivals").
    • Advanced Customizations: Refine filters (e.g., exclude discounted items).

Changes are saved instantly. Please allow up to 10 minutes for updates to be reflected in the Playground environment.