Malachyte Portal/Pages

Playground

How to preview product listing pages in the Playground

The Playground is a simulation environment that previews how the product listing page experience will appear for different shoppers, products, and domains.


Accessing the Playground

  1. Open the left navigation menu
  2. Click on Pages
  3. Click on the Playground tab

Simulating the Experience

Follow these steps to preview how a product listing page experience will appear:

  1. Select the applicable domain scope
  2. Select a collection from the dropdown or use the search field
  3. Click Generate Preview

Note

Previews may take up to 30 seconds to load.

The preview shows results before personalization. It reflects the component's strategy and any rules, but not each shopper's personal ranking, so what shoppers see on your site can differ.


What the Playground Shows

Merchandising Preview

  • Pinned products appear in their exact grid positions
  • Promoted products are boosted toward the top
  • Buried products appear lower in the grid
  • Hidden products are not displayed
  • Single card banners appear in their designated product slots
  • Full row banners span the grid width between rows
  • Banner positioning reflects the absolute dataset index

Filter Preview

  • Only enabled filters from allowed_filter_attributes are displayed
  • Filter ordering matches the Portal configuration
  • Applying filters updates the preview in real-time

Merchandising Rules

Merchandising rules can be tested directly in the Playground to see how they impact product ranking before going live.

Important

Rule changes made in the Playground are strictly temporary. They will not affect the live experience until they are explicitly saved to a component.

Rule Types

There are two types of rules:

  • Global Rules: Apply across all collections or product listing pages.
  • Page-Specific Rules: Apply only to a specific collection or product listing page.

Both rule types can be managed directly within the Playground or via the Rules tab in the main navigation. Existing active rules will populate automatically when the preview loads.


Previewing Rules in the Playground

There are two ways to preview rules in the Playground:

Method A: Using the Rule Builder

  1. Click the ADD RULE button to configure a new merchandising rule. Click "Add rule" to update the preview.
  2. It may take up to 30 seconds for the preview to update.
  3. Once the preview updates, it shows the new sequence of products based on the applied rule.

Method B: Visual Pinning (Drag-and-Drop)

  1. Click and hold a product tile within the preview, then drag it to the desired position.
  2. This automatically generates a pinning rule for that product location.

Saving Rule Changes

There are two options to save rules created in the Playground:

  • Update Global Rules: Click UPDATE GLOBAL RULES to navigate to the Global Rules management screen, to review and confirm the changes.
  • Save Page-Specific Rule: Click the + button next to any page-specific rule created in the Playground to open the creation flow with the rule settings pre-populated.