You can now export your catalog data from Constructor using the Tasks API. This gives your team a repeatable, self-serve way to generate an export file on demand and download it once it’s ready.

What’s new

• Create a Catalog Export task and get back a task ID.
• Check status and download the export file once it’s ready.

Why it matters

• Makes it easier to validate your catalog, troubleshoot issues, and share data with downstream systems.
• Gives you a self-serve way to generate exports without needing manual support.

Common customer use cases

• Catalog QA after an ingest change: Export items/variations and compare against your source feed to confirm the right fields are present and updated.
• Troubleshooting unexpected search/browse behavior: Pull an export to spot missing attributes, incorrect values, or out-of-date availability/pricing.
• Downstream processing / audits: Generate a point-in-time export to load into your own tools (data warehouse, scripts, BI) for analysis and reconciliation.
• Taxonomy review (item groups): Export item groups to review hierarchy structure and naming, and to validate updates before broader changes.

How to use it (high level)

• Create an export task → get a task ID.
• Check status until it’s DONE.
• Download the file using the returned URL.

Notes

• Only one export can be queued or running per ac_key at a time.
• Depending on what you’re exporting, you may need to provide both ac_key and section.

Learn more about Catalog Export API

At Constructor, we strive to give merchandisers transparent visibility into what drives performance - and with this update, rule performance analytics now show up right within the merchandising workflow in the Searchandizing Search and Browse tables, so you can spot underperforming rules and act faster.

With this update

• You can see Page Impact and Items Impact badges directly in the Searchandizing tables.
• The tables now surface key metrics like Pageviews, Purchase Rate, Purchases, and Revenue.
• Hover a badge for a quick overview of rules impact, or click to open a side panel with a full breakdown of the impact on clicks, add-to-carts, and purchases, as well as individual rule impact.

How to get started

1. In the dashboard, go to Searchandizing → Search (or Searchandizing → Browse).
2. Find the Rule Impact column and review the impact badges.
3. Hover a badge to see a quick summary, or click it to open the detailed impact panel.

Learn more about manual rules impact

If you have any questions or feedback, please connect with your Customer Success Manager.

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

Catalog upload operations, Create or replace catalog. 

Merchandising Recommendations just got a big upgrade: you can now benefit from the same powerful set of preview and rule capabilities that you know and love in Search and Browse.

With this update

• Preview pods with full context controls:
  • Use Impersonate to preview pod experience for a particular segment of shoppers.
  • View Changes explicitly communicates the impact of boost and bury rules.
  • Select Attributes to be displayed on product tiles.
• Use the affecting rules dropdown to see which rules are already impacting the pod’s shopping experience before creating new ones.
• More controls to curate pod experience:
  • Use Ranged Slotting to keep a curated set of items within a position window while still letting ranking optimize the exact products and order inside that range. Learn more
  • Use Variation Slicing with filters to control which variations appear based on explicit conditions. Learn more
  • Use drag-and-drop slotting from the carousel to quickly create slot rules.
• Move faster with import/export: Download a CSV of your variation-level slotting rules, edit in bulk, then upload it back — ideal for large promos, quick iterations, and sharing setups without manual clicking. Learn more

How to get started

1. Go to Recommendations → Rules.
2. Open an existing campaign (or create a new one).
3. In preview, you will find the updated merchandising toolkit:
   • Affecting rules
   • Segment impersonation
   • View changes
   • Attributes on product tiles
   • Ranged Slotting
   • Variation Slicing with filters
   • CSV Item Variation Slotting import/export

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

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.