Keeping your catalog clean is hard when it’s built from multiple upstream sources—products can disappear upstream but still linger in Constructor. Whitelist Action gives you a fast way to clean up stale catalog data by telling Constructor what to keep.

With this update:

• Upload a keep-list of item, variation, and/or item group IDs.
• Anything not on the list is removed, so you can do a “keep this set, drop the rest” cleanup without a full feed re-upload.
• Supports CSV, JSON, JSONL, and .tar bundles containing any mix of supported files (items, variations, item groups).
• Includes built-in safety checks to help prevent accidental large deletions (override available for intentional large cleanups).

How to get started

• Supported entity types: items, variations, and item groups.
• File formats: CSV, JSON, JSONL, or a .tar bundle containing any mix of supported files.
• Built-in deletion safeguards: by default, Whitelist Action won’t delete more than 50% of a catalog in a single run (override available).
• Cascade rules: deleting items also deletes their variations; deleting item groups validates that the tree structure won’t break.
• Payload requirement: whitelist payloads must include only ID fields; extra fields will error.
• Override option: override the failsafe threshold with the forcewhitelist keyword (use with caution).

📓 Links to additional documentation

- Public Docs -

Constructor DocumentationCreate or replace catalog

Merchandising calendars move fast — and updating collections by hand at the right time can be challenging, especially early in the mornings or on weekends. The new Scheduled Item Sets feature lets you plan item rotations in advance, while keeping a single stable collection.

With this update you can:

• Create multiple time-bound item sets inside a single collection (with optional start/end dates).
• Automatically serve the right items without creating separate collections per promo window.

How to get started

We will gradually roll out Scheduled Item Sets over the coming weeks. If you would like early access, please reach out to your Customer Success Manager.

1. Go to Searchandizing → Collections.
2. Open a collection.
3. In Scheduled Item Sets dropdown at the top right, click Create new scheduled item set.
4. Add items (item IDs, .csv, or conditions) and optionally set a Start/End date.

Note: Updates are evaluated on a short interval, so an item set scheduled for a specific time may activate/deactivate within up to 2 minutes after the scheduled time.

If you have any questions or feedback, please connect with your Customer Success Manager or contact us through support@constructor.io.

Merchandising campaigns are a powerful way to curate products consistently across multiple contexts — but it might be daunting to track the impact of those changes.

With Campaign Performance, each Searchandizing campaign now has a dedicated Performance page that compares results before vs after the campaign was created (organic baseline vs campaign period).

What's New

• Pre/Post comparison chart: View “Pre” and “Post” lines for key metrics, with the “Post” period starting automatically from the campaign creation date.
• KPI summary cards: Quickly review Pageviews, Clicks, Add-to-Carts, Purchased Items, plus CTR / ATC rate / Purchase rate.
• Item & page-level drilldowns: Use sortable tables to identify which items and pages/contexts are improving — and which need intervention.

How to Get Started

We will gradually roll out Campaign Performance over the coming weeks. If you would like early access, please reach out to your Customer Success Manager.

Once the feature is enabled:

1. Go to Searchandizing → Campaigns.
2. Open an existing campaign.
3. You will find the new Performance report with charts for the whole campaign metrics and tables to drill down into Items and Contexts.

If you have any questions or feedback on the feature or the Constructor dashboard in general, please connect with your Customer Success Manager or contact us through support@constructor.io.

Effective merchandising depends on understanding the full context behind what shoppers see — especially as you layer on new strategies and promotions. When you merchandise a Search or Browse page, you can now see exactly which rules are already influencing the results, including those that come from Campaigns or Global configuration.

With this update

• See all rules affecting the page you are previewing (page-level, Campaigns, and Global) to avoid creating conflicts
• Review rules grouped by where they come from, so you can jump to the right place instantly
• Troubleshoot faster when results look off

How to get started

1. Open Searchandizing
2. Navigate to any context (Search, Browse, or Campaigns)
3. Open the page preview
4. Select Show other rules affecting the page
5. Review the impacting rules list, grouped by source context
6. Use the context links if you need to adjust the originating rules

If you have any questions or feedback on the new feature or the Constructor dashboard in general, please connect with your Customer Success Manager or contact us through support@constructor.io.

At Constructor, we always strive to provide digital merchandisers with rich tools to curate shopping experience. With the new Ranged Slotting rule and advanced conditions, we introduce unparalleled flexibility to keep product listing pages organized and visually appealing, while still benefiting from Constructor's AI ranking.

Previously, slotting rules allowed to place items with a selected attribute into individual positions — up to 5 at a time. Now, you can define ranges of up to 250 positions per page, while Constructor ranks and personalizes results within those.

This enables powerful visual curation of product listing pages:

• Keep most attractive new arrivals always in the first two rows of a collection page
• Push out-of-stock items to the bottom of results
• Ensure each row presents a curated mix of product categories or colors

On top of ranges, we are also bringing advanced conditions to flexibly define items for slotting. You can now combine multiple attribute conditions with AND/OR logic, having precise control over which products should fill a range of positions — without manually picking items one by one.

Ranged Slotting works across Search, Browse, Collections, and Campaigns, so you can maintain a consistent page structure anywhere your shoppers discover products.

What's New

• Position ranges: Define ranges, such as positions 1–20, instead of individual positions, with up to 50 positions per one rule and 250 positions per page in total
• Advanced conditions: Use AND/OR filter expressions to precisely target item groups
• AI ranking within ranges: Constructor's algorithms use ranking score to select the most attractive, personalized items defined by attribute-based conditions
• Graceful partial fill: If there are fewer items that match conditions than positions in the range (e.g., 15 blue items for a 20-position range), the matching items fill from the top and the remaining positions are filled automatically based on Constructor's AI ranking

How to Get Started

We will gradually release the new rule over the coming weeks. Please, reach out to your Customer Success Manager if you would like to ger early access.

Once the feature is enabled, navigate to Searchandizing and create a new Ranged Slotting rule. You will see the new range selection and advanced condition builder in the rule configuration panel. 

Learn more in our guide

If you have any questions or feedback on the new feature or the Constructor dashboard in general, please connect with your Customer Success Manager or contact us through support@constructor.io.

The best merchandising decisions are the ones you can defend with data. You've been slotting, boosting, and tuning pages for weeks — but when the data says the page is down, which rule caused it? Now, with this major update to Merchandised Page Performance, you can finally get an answer to that question.

• ⚡ Individual Rule Performance — open any page's details drawer to see a breakdown of every rule's contribution: Page Impact (its estimated share of the total page-level metric change) and Items Impact (the direct before/after performance of the items it affected). Two lenses, one table, zero spreadsheets;
• 💨 Redesigned header — Positive, Mixed, Negative categories now show page counts and switch in a single click. Finding what needs attention just got a lot faster;
• 👴 Smarter aged rules — a rule that's been running quietly for three months and still delivering results is not a problem. It's just old. Old rules are no longer auto-flagged as negative — use the new toggle to surface them only when you want to.

Support for additonal rule types, facet configurations, and more actionable insights are already on the way.

Sort options help shoppers navigate and make sense of large sets of results. They improve the shopping experience by giving shoppers a more organized, tailored way to view products (for example, sorting by price or rating).

With this update, you can now manage sort options directly in the Customer Dashboard, without using the API:

• View already configured sort options
• Create new sort options
• Update existing sort options
• Delete sort options you no longer need

How to get started

1. In the Customer Dashboard, go to Workspace → Indexes, then click Sort Options.
2. Click Create sort option.
3. Fill in the fields:
   • Sort by — internal identifier for the sort option (used by the system to reference it)
   • Sort order — whether results should be sorted ascending or descending
   • Display name — the label shoppers see in the sort dropdown (for example, “Price: Low to High”)
   • Path in metadata — the item field to sort on (for example, price, rating, or product.rating)
   • Position — the order this sort option appears in the list of sort options shown to shoppers
   • Visibility — whether this sort option should be visible to shoppers by default
4. Click Create to save.

To manage sort options in the dashboard, users require an admin role or an explicit  Sort Options permission within a custom user role. The default sort option by relevance is configured during the index setup and can be changed only via API. Changes to sort options require an index rebuild, which usually takes a few minutes. You can learn more about sort options in our API reference.

If you have any questions or feedback on the new feature or the Constructor dashboard in general, please connect with your Customer Success Manager or contact us through support@constructor.io.

The dashboard just got a major upgrade for item-level analytics. Starting today, all Constructor dashboard users can explore the full onsite shopper journey for any item — not just what happened, but exactly where it came from.

• 🔀 See traffic source breakdowns — for any item, see what share of views, add-to-carts, and purchases came from Search, Browse, Collections, Facet Pages, and Recommendations, and which channel actually converts best;
• 📉 Visualise the conversion funnel — trace the full journey from pageview → click → add-to-cart → purchase, broken down by source, to spot exactly where shoppers are dropping off.
• 📋 Drill into the Pages table — a ranked list of every specific page driving traffic to this item, with per-page purchase rate and % of total purchases, down to the exact search query or category page. From any row, jump directly to Interact or Analytics to act on what you find.

Item Analytics used to tell you what happened. This update tells you why — and where to act, contributing to our mission: help eCommerce teams spend less time asking "where did this come from?" and more time acting on what they find.

We're continuing to build on this by bringing more sources, controls and ultimately connecting it with offsite traffic to give a complete end-to-end shopper journey view.

Constructor's AI-powered badges help shoppers quickly identify popular, new, or trending items, making it easier to find products they'll love. These visual labels appear on item tiles and are calculated and assigned automatically, ensuring application to the right products at the right time to boost business KPIs.

With this update, badge assignments are now fully transparent in the Interact section of the dashboard. You can:

• See which items have badges: Instantly view all badged items on any search or browse page, along with their positions in the results
• Understand why: Hover over any badge to see a detailed explanation of why that item received it (e.g., "Bestseller: Top 15% of items by purchases over the last 30 days")
• Review your shopper experience: Quickly verify that badges are being applied as expected and provide feedback when they're not

This transparency helps you understand how Constructor is enhancing your product discovery experience and gives you confidence that badges are driving value for your shoppers.

How to Get Started

This feature is available now for all indexes with badges enabled. Open a search query or browse page in Interact, and look for the Badges section in the Ranking Factors area. Click the counter to see all badged items or scroll the items grid. Hover over a badge to find explanation why an item received it.

If you're interested in enabling badges or have questions about how badges work, learn more in our badges documentation or connect with your Customer Success Manager.

Launching a collection tied to a marketing campaign or limited-time drop often means a tradeoff: prepare early  and risk products showing up too soon, or wait until the last minute and scramble to launch on time.

With Scheduled Collections, you can now set start and end dates for a collection so it is only available to shoppers during the time window you choose.

This means you can:

• Prepare in advance: Build and QA your collection days or weeks ahead of launch.
• Launch on time: The collection becomes available automatically at your scheduled start date.
• End cleanly: Limited-time collections stop being available automatically after the end date (API returns 404 Not Found).

How to Get Started

In the dashboard, navigate to Collections, then create a new collection or edit an existing one. Set your start and or end date to schedule when the Collection should be available.

Note: Updates are evaluated on a short interval, so a collection may become available up to 2 minutes after the scheduled start time.

If you have questions about this release or Collections in general, please connect with your Customer Success Manager or contact us through support@constructor.io.