May 2025

📚 New articles

• Create searchandising rules and apply them in multiple contexts at once. Merchandisers can now define and deploy a single strategy across multiple search, category, and facet contexts—without creating individual rules for each one. Learn how in our Create searchandising campaigns article.

April 2025

📚 New articles

• Curate facet groups and options on specific results pages. While companies should feel confident allowing Constructor's facet sorting algorithm to identify and order facet groups dynamically, there may be instances where merchandisers wish to curate the facet experience of a specific results page manually. Learn how in our Curate facet groups and options on specific results pages article.
• Slot by item or attribute on results pages with specific filters (facets) applied. When viewing items in a category or collection, users can apply facets, or filters, to refine the displayed items. Merchandisers can now control which items are slotted during these filtered shopping experiences. Learn more in our Create a facet searchandising rule page.
• View item recall and ranking details in Interact! A newly launched UI delivers transparency into how items perform in specific queries and browse pages. This includes highlighting which ranking factor played the biggest role in an item’s score. Learn more in our View item recall and ranking details in Interact article.

🚨 Important updates

• Using the Constructor Dashboard section gets a new structure! We recently updated the order of articles within this section to mirror the Workspace section and tools within the Constructor app.

March 2025

📚 New articles

• The Shopify Connector is here! Constructor's Shopify Connector allows you to connect your Shopify company to Constructor and provides Liquid UI components out of the box that can speed up your integration by dragging and dropping these components to your store. Learn more in our Shopify UI article.
• Deliver related search suggestions with every search experience. With Related Search, generate suggestions that guide users towards other or more effective queries that might interest the user. Learn more in our Related Search article.
  • Also released with Related Search: Implement Related Search.
• Display badges on results pages to highlight specific items. Badges are visual labels on item tiles that encourage purchasing by highlighting important information about the item. They help shoppers quickly identify popular, new, or trending items, enhancing their shopping experience. Learn more in our Badges article.
  • Also released with Badges: Implement Badges.
• Optimize organic and sponsored revenue with Sponsored Listings. Advertisers can promote items for specific search queries and browse pages, while Constructor leverages its ranking algorithm to ensure that listings that are relevant, attractive, and more likely to convert show for a user. Learn more in our Sponsored Listings article
  • Also released with Sponsored Listings: Implement Sponsored Listings.
• Use Sponsored Listings with your third-party retail media network (RMN). Sponsored Listings offers the ability to marry RMN campaign information with the power of Constructor’s ranking algorithms. We call this our mediation layer. Learn more in our Mediation Layer article.
• Using Sponsored Listings in the Constructor dashboard. Companies can create and manage campaigns on behalf of advertisers through the Constructor dashboard. Please refer to the resources below for assistance.
  • Configure Sponsored Listings. Decide which browse category pages can allow ads.
  • Create a campaign. Create a sponsored campaign for an advertiser.
  • Manage campaigns. Edit, pause, or suspend advertisers' sponsored campaigns.
  • View sponsored campaign performance. View overall campaign performance or performance by specific advertisers.
• Helps trusted advertisers create and manage sponsored campaigns. Advertisers can create and manage campaigns for their products from their own dedicated dashboard. Please share the resources below with your advertisers.
  • Invite users to the advertiser dashboard. Invite trusted advertisers to a dedicated dashboard where they can create and manage their sponsored campaigns.
  • Create a campaign. Discover how advertisers can create a sponsored campaign for their products.
  • Manage campaigns. Learn how advertisers can edit, pause, and view the status of their campaigns.
  • View campaign analytics. Learn how advertisers can view performance analytics for their campaigns.

🚨 Important updates

• Constructor now supports ingesting both JSON and JSONL files in addition to CSV. We’ve reorganized our Product Catalog section into two main areas that should help provide consistency and clarity for your teams.
  • Catalog updates via HTTP or FTPS. This section contains all information on sending catalog files (CSV, JSON, or JSONL) over HTTPS or FTP.
  • JSON data via REST API. This section contains all information on sending JSON data over the REST API.

February 2025

📚 New articles

• Configure single sign-on (SSO) for Constructor. Learn more about implementing SAML and OAuth 2.0 SSO with Constructor in our single sign-on (SSO) article.
• Configure hierarchical facets. Hierarchical facets allow Constructor to format a facet response in a nested/hierarchical format. Learn more in our Configure hierarchical facets article.

January 2025

📚 New articles

• Considering a move to Constructor from Bloomreach? The process is easier than ever with Constructor's ability to ingest data files built for a Bloomreach integration. Learn how to make the switch in our Migrate from Bloomreach article.
• Influence item ranking scores with boost and bury rules. Every item on the results page of a search query and the results of a browse page has an item attractiveness score. Learn how you can increase (or decrease) this score in our Create boost and bury rules article.
• Learn the ins and outs of managing searchandising rules. Learn how to view, edit, delete, and copy searchandising rules in our Manage searchandising rules article.
• Understand metric calculations across Constructor products. Learn how Constructor calculates various metrics across products with the help of our Metrics glossary.

🚨 Important updates

• Greater control over boost and bury rules is here! Constructor has improved upon available boost and bury functionality to offer merchandisers greater control over the strength of boost and bury rules. We walk through the changes to boost and bury rules in our Changes to Constructor's boost and bury rules article.
• A refresh on metadata and facets. We have updated our Metadata and facets article following the November update to facet configuration.

November 2024

📚 New articles

• Return similar products based on an uploaded image. Learn how Constructor returns results for searches where shoppers upload an image of an item they’re looking for into the search field of the retailer’s website or mobile app. Learn more in our Image Search article.
• Impersonate a custom user in Interact. Create a user with a specific behavioral history and impersonate them in Interact to see how those behaviors impact item ranking. Learn more in our Create custom user profiles article.
• Enrich item and category data with Attribute Enrichment Learn how Constructor can improve your catalog data by tagging items with new, relevant attributes and categories regularly. Learn more in our Attribute Enrichment article.
  • Also released with Attribute Enrichment: Review enriched attributes and view Attribute Enrichment analytics.
• Helper functions for Connect CLI are now available! Helper functions for available connectors (e.g., BigCommerce, commercetools, and Shopify) can help you develop your templates. There are also global helper functions. Learn how in our Connect CLI helper functions documentation.
• Configure global facets within the Constructor dashboard. You can now configure facet type and visibility using the Constructor dashboard. Learn more in our Configure global facets article.

🚨 Important updates

• Starting November 6, 2024, facets will no longer be defined during catalog upload. Our documentation previously reflected the ability to define facets during catalog upload. However, as this is no longer the experience, we have updated our documentation to reflect the current state. Moving forward, facets can be defined as metadata during catalog upload, then configured either through the Constructor dashboard or our API. Visible facet configurations are not created automatically. Please note that only admins will have the ability to configure facets via the dashboard.

October 2024

📚 New articles

• Get granular with your promotions by slotting items by variation. With variation slotting, you can now feature or "pin" a specific item variation on the results page of a search query, browse category, collection, or facet page. Learn how in our Slot items by variation article.
• Copy individual rules for Search and Browse across indexes. Save time recreating a searchandising rule by copying it from one index to another. Learn how in our Copy individual rules across indexes article.
• Constructor's Glossary is live! Learn the definition of key terms that appear in Constructor documentation in our term glossary.

September 2024

📚 New articles

• Curious how results ranking works at Constructor? Our newly improved Results ranking at Constructor article takes you behind the scenes of the ranking algorithm to deliver clarity around how each stage, advanced signals, and merchant-defined rules contribute to the ranking score assigned to every item in a results set.
• Constructor's Connect CLI documentation is live! With Connect CLI, you can map and transform your catalog data via any connector, allowing you to develop and manage your catalog integrations easily. Learn more in our Get started with Connect CLI article.