Introducing a major update to API tokens that gives your engineering and admin teams precise, "least-privilege" control over API access.

The Challenge: The "All-or-Nothing" API Key

Previously, API tokens (now referred to as Legacy tokens) were company-wide, granting full read and write access to all Constructor endpoints across all your indexes. While powerful, this created potential risks. A leaked token technically, could expose all your data, and a simple misconfiguration in a script could accidentally apply changes to the wrong environment.

The Solution: API tokens with Custom Level of Access

Now, you can build API tokens with a specific, limited scope. When creating a new token, you can define:

• Indexes: Specify which indexes the token can access. This is perfect for isolating your Production, Staging, and Dev environments or managing different websites.
• Scopes: Select which API endpoints the token can use (e.g., searchandising.refined_queries, searchabilities,  synonyms).
• Permission: Define the permission level for those scopes: Read & Write, Read, or Write.
• Expiration Date: Set an optional expiration date. We recommend renewing API tokens regularly.

By limiting access to what is really needed, you reduce security risks if a token gets compromised and rule out the possibility of applying changes to the wrong environment.

Putting API Tokens into Practice

This new control allows you to securely manage complex, multi-team workflows:

• For Integration Scripts: Create an API token that has access only to scopes within the dev_index to test things before applying changes in production.
• For Regional Teams: Give your EU engineering team an API token that can Read & Write to all scopes only on the eu_site index, preventing accidental changes to the US site.

Better Together: API Tokens + Customizable User Roles

This update works hand-in-hand with our recent Customizable User Roles feature. Only users assigned with a role that has Manage API tokens permissions can set up API tokens. Users' ability to create API tokens is limited by their role permissions. An administrator can create tokens for any scope, but a user with a specific role (e.g., "US Merchandiser") can only create API tokens for the indexes and features they are already permitted to access. 

This ensures your permission model is consistent, from the dashboard UI right down to the API.

A Note on Legacy API Tokens

Your existing tokens (now labeled Legacy tokens in the dashboard) will continue to work without interruption. However, you can no longer create new tokens of this type. We highly recommend you audit your existing integrations and begin migrating to the new, more secure API tokens as part of your team's security best practices.

How to Get Started

This feature is now live for all customers. Administrators and users with the appropriate permissions can create new tokens by navigating to Integration > API Tokens in the dashboard.

For a complete, step-by-step guide, please visit our updated documentation: Generate and manage API tokens.

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 analytics experience it taking a big leap forward. Starting today, all Constructor dashboard users can enjoy a more powerful, searchable, and segmentable analytics interface designed to make finding insights effortless.

With this update, merchandisers can:

• 🔎 Search within analytics tables across Search, Browse, and Recommendations — no more manual scrolling or exporting to find specific data points.
• ↕️ Sort by key metrics (clicks, conversions, revenue, etc.) to instantly spot what’s performing best — or what needs attention.
• 🌎 Filter analytics to uncover how different audiences behave: by geo, device type, customer-uploaded segments, Affinity, or RFM segments.

In short: you can now slice, search, and sort performance data however you need — directly in the dashboard.

Why it matters 🎯

Our users have long asked for better ways to prove impact and make data-backed decisions faster. This release brings analytics closer to that vision:

• Understand who your shoppers are and how they behave across Search, Browse and Recommendations.
• Quickly compare audience segments (e.g. iOS vs Android shoppers, Canada vs US, newcomers vs loyal shoppers).
• Focus on the moments that drive your business without leaving the dashboard or relying on exports.

These improvements make analytics both more powerful and more human, helping merchandisers move from data collection to real, actionable insight.

What’s next 🔜 

We’re continuing to expand these capabilities across the entire dashboard — bringing segment-level analytics, powerful tables, and unified interactions to more pages and reports soon.

Our mission is simple: to help merchandisers spend less time searching for insights, and more time acting on them.

We are excited to release a mighty enhancement to the Customizable User Roles feature: you can now assign multiple roles to a single user directly from the dashboard. This simplifies permission management and scaling your team's access with enterprise-grade flexibility.

The Challenge: Scaling Role Management

Since launching Customizable User Roles, we've heard feedback from large teams managing numerous brands, regions, or environments. A common challenge was managing users who needed combined permissions.

For example, to grant a developer access to both the EMEA and NA indexes, you had to create a specific "Dev EMEA + NA" role. For complex teams, this led to a long, hard-to-maintain list of "combination" roles (e.g., "Merchandiser US+EU", "Merchandiser B2B+B2C").

The Solution: Multiple Roles for Simple, Granular Control

With this update, you can now assign the existing "Dev EMEA" role and the "Dev NA" role to the same user. This approach provides powerful benefits:

• Reduce Admin Overhead: You don't need to create and manage dozens of redundant "combination" roles. Simply assign the building blocks you've already created.
• Scale with Flexibility: Easily manage permissions as your team grows and responsibilities change. Need to give a B2C merchandiser temporary access to the B2B site? Just add the "B2B Merchandiser" role and remove it when the project is done.
• Smart, Additive Permissions: Access is combined in the most permissive way. If one role grants View access and another grants Edit access for the same feature, the user will automatically get Edit access.

How to Get Started

Users with the Manage users permission can select and assign multiple roles to a single user directly from the dashboard. Navigate to the User Management page by clicking on your name in the bottom left corner, and then, Team Members. Click on the current role assigned to a user and select multiple roles in the dropdown.

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

What's new

You can now target customer-defined user segments across most searchandising rules—not just Boost & Bury. That means you can adjust ranking, recall, content, and slotting for specific audiences (e.g., "US App Users", "Loyalty Tier Gold", "Clicked Meta Ad A") without rebuilding pages or bluntly applying rules to everyone.

You can now

• Apply segments to key rules and surfaces
  • Boost & Bury — Search, Browse, Campaigns, Recommendations, Global
  • Item Slotting (incl. CSV & faceted browse) — Search, Browse, Campaigns, Recommendations
  • Attribute-based Slotting — Search, Browse, Campaigns, Recommendations
  • Allowlist / Blocklist — Search, Browse, Campaigns, Recommendations (Blocklist also on Global)
  • Content Rules — Search, Browse, Campaigns
• Preview as a segment when creating Campaigns: Impersonate a selected segment to see exactly what that audience will experience before you ship.

Why it matters

Previously, segments were available for Boost & Bury only. Teams either ignored insights or applied broad rules to all shoppers, diluting performance. With segments available across your core rule types, you can:

• Tune the same PLP differently per audience (locale, device, lifecycle stage).
• Move faster from marketing signal to on-site personalisation without duplicating pages.
• Protect performance by narrowing rules to only the shoppers they're meant for.

Example workflows

• Campaign continuity: For users who clicked a specific ad or email, slot the exact products that match the message they saw, right on arrival.
• Locale nuance: Slot a colorway or size range for only a particular country/segment without touching other markets.
• Compliance fast-track: Blocklist prohibited items for a single region while keeping them live elsewhere.
• Channel-aware content: Show different banners/copy to app users vs web visitors on the same PLP.

Who benefits

• Merchandisers partnering with Marketing: align landing experiences to campaign promises.
• Region/brand owners: tailor assortment and messaging by locale without forking your catalog.
• Compliance & ops teams: react quickly to region-specific restrictions.

Coming soon

• AI-generated segments
• Segments in Content Rules (Global)
• Segments in Variation Slicing
• Impersonation for Search, Browse, and Global

Learn more

• Configure searchandising rules
• Create a searchandising campaign

To learn more, please contact your Customer Success Manager or support team.

What’s new

We’ve supercharged Collections so merchandisers can build, reuse, and refine PLPs with fewer clicks.

You can now

• Export item IDs to CSV from a Collection in one click—for analysis or to seed a new Collection.
• Add, edit, and remove item IDs inline in the Collections UI—no extra CSV wrangling required.
• Copy a Collection across indexes or within the same index—reuse successful setups with minor tweaks.

Why it matters

Previously, small changes took a big effort—exporting item IDs required workarounds, editing meant creating and re-uploading CSVs, and reusing a Collection often meant rebuilding from scratch.

Now you can:

• Move faster from idea to live PLP.
• Keep Collections fresh with quick, precise Item ID updates.
• Replicate proven merchandising strategies across storefronts without busywork.

Example workflows

• Re-launch a winning PLP in a new market: Copy the Collection to another index, adjust a few IDs inline, and publish.
• Clear handoff material: Provide item ID CSVs for cross-team reviews, ensuring everyone’s working from the same list.
• Tweak on the fly: Paste a handful of new item IDs straight from a spreadsheet and remove outdated ones in seconds.

Learn more

• Create a Collection
• Manage a Collection

Introducing Online LLM Burying Models—a new AI-powered enhancement that makes your search results cleaner, sharper, and more relevant in real time.

Our system now analyses each query as it happens, identifying and removing the least relevant results on the fly. Unlike the previous offline model, which could only filter precomputed query–item pairs, this new online model works on every search call, ensuring consistent precision across your entire catalog.

Benefits include:

• Higher precision: Irrelevant or misleading products are automatically detected and pushed down or removed.
• Smarter intent understanding: The model interprets the true meaning of each query to deliver more accurate matches.
• Improved search quality: Cleaner and more relevant results help users find what they need faster.

This update strengthens your search engine’s ability to interpret intent and deliver only the most meaningful results, helping shoppers find exactly what they’re looking for with confidence.

This enhancement is now available in AB test to all our customers.

To learn more, please contact your Customer Success Manager or support team.

We are excited to announce the general availability of Customizable User Roles with View/Edit permissions. This powerful new capability is now live in the Constructor dashboard for all customers. 

This feature allows enterprise e-commerce companies to provide every member of their team with tailored access, ensuring they have exactly the tools they need to excel—without compromising security or control.

The Challenge: Scaling Operations Securely

As an e-commerce business scales, more teams rely on a central platform for daily tasks. The Merchandising team fine-tunes results across the product discover journey, the Marketing team builds campaign-specific collections, and the Development team manages integrations and indexes. Each team has a unique focus, and providing one-size-fits-all access can create bottlenecks and introduce the risk of accidental changes to critical settings.

The Solution: Granular Control, Tailored for Your Business

Customizable User Roles solve this challenge by providing precise control over what each user can do. This functionality allows you to:

• Safeguard Critical Settings: Protect company-level information, such as API tokens and user management, by restricting access to only designated administrators. 
• Isolate Access by Index: Assign users to specific indexes, making it perfect for managing different regions, websites, or environments (e.g., Staging vs. Production) without overlap. 
• Assign Feature-Specific Permissions: Grant Edit permissions for individual features. Empower your merchandisers to manage Searchandising and Facets while restricting access to A/B Testing or Recommendations for designated roles. 
• Promote Data-Driven Decisions with View-Only Access: Create view-only roles for executives, analysts, and other stakeholders. This allows them to access valuable performance reports and analytics without the ability to make changes. 

Putting Roles into Practice 

With this level of control, you can create highly specific roles that map directly to your operational structure: 

• The Digital Merchandiser (B2B): Gets Edit access to Searchandising, Facets , Collections, A/B Testing, and Global Facet Configuration for the B2B website index, but has View access everywhere else. 
• The Marketing Specialist: Can only Edit the Collections feature to prepare for an upcoming email campaign. 
• The Regional Manager (EU): Has View access to global indexes but can only Edit merchandising rules for the eu_site index. 
• The Developer: Is given Edit access to the staging_index to test a new integration but has only View access to the production environment.

How to Get Started

This feature is now available in your dashboard. Administrators can begin creating and assigning roles today by clicking on their name in the bottom left corner, then Team Members, then switch to the User Roles tab. For a detailed walkthrough on creating roles and assigning permissions, please visit our documentation 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.

We’re excited to introduce the Continuous Optimization Report in your Constructor dashboard. This report gives you full visibility into how Constructor’s tailored Continuous Optimization Plan drives measurable revenue impact for your business.

💡 What is the benefit?

Constructor has always taken a unique approach to delivering value – not through one-size-fits-all algorithms, but by tailoring search and discovery variants to each customer’s goals and shopper behavior. Until now, these results were shared mainly in your touchpoints with our Customer Success and Data Science teams. With the Continuous Optimization Report, you can now track how experiments are generating value to your business directly in your dashboard, ensuring transparency and confidence in the ROI Constructor delivers.

📍 Where to find it?

You can access the Continuous Optimization Report in your dashboard by selecting Optimization from the side menu. There you’ll see the combined annualized revenue lift from completed experiments, a list of experiments with details like revenue lift, annualized projections, and important context about each experiment's hypothesis. Click any experiment to see its setup, metrics, and outcomes – all in one place!

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

We know many of you have been waiting for this one — and we’re excited to share it’s finally here!

We're introducing Merchandised Page Performance (MPP) — a brand-new report that finally gives merchandisers the data to prove when manual ranking rules are helping or hurting business metrics.

Until now, rules were a bit of a black box. You could push a product up or bury something you didn’t want to show, but measuring the impact was tricky. Were these rules actually helping your business goals? 

Besides unresolved questions, merchandisers have struggled to show stakeholders whether manual merchandising decisions — like boosting new arrivals, slotting hero products, or burying poor performers — were driving results or dragging down conversion. 

With Merchandised Page Performance, you don’t have to guess anymore. The report shows:

• All pages with active manual ranking rules in one place (search, category, collections, facet pages).
• Before-and-after performance (7-day windows) for the page overall (Page Impact) and for the items affected (Items Impact).
• Easy-to-read suggestions (our little lightbulbs 💡) telling you when a rule might be helping, hurting, or ready to retire.

Here’s how customers are already using it:

• When they launch a new set of rules, they monitor the report daily for the first week to see how things are progressing.
• As a go-to tool to clean up and remove rules that no longer serve their needs.

This means less manual effort, faster insights, and more confidence that every merchandising decision is helping you hit your targets.

You can find Merchandised Page Performance today in your dashboard under:

 Analytics → Rule Performance → Merchandised Page Performance

We’re thrilled to see how you’ll use it to fine-tune your strategy. And this is just the beginning — we’re already working on making the report more granular (down to individual rules), faster  and even more powerful.

📖 Learn more in our documentation.

We’re excited to announce a new capability that makes it much easier to manage time-sensitive changes in your catalog: Metadata Overrides.

Until now, if you wanted an attribute like price to change at a specific time (for example, to match the start of a sale at exactly 9pm ET), you had to carefully time your ingestion and indexing. That was always a hassle, especially when marketing campaigns needed precise alignment with communications.

With Metadata Overrides, you can plan ahead. You simply ingest future values in advance (e.g. price_october_campaign) and then configure them to automatically override the main field (price) at the exact date and time you choose. During that window, Constructor will serve the override value in all relevant APIs (Search, Browse, Autosuggest), and once the window ends, it will automatically fall back to the original field.

💡 How it helps

• No more late-night ingestions: Set it once, and the switch happens at the exact time you want.
• Perfect campaign alignment: Prices, badges, and other metadata can flip in sync with marketing messages.
• Reliable rules: Filtering, sorting and searchandizing rules will respect the override values, so everything behaves as if the new value was the original.
  
  

🧩 How to use it

1. Ingest your future fields in advance
   
   

   • Add additional fields in your feed that hold future values (e.g. price_october_campaign, promo_price_q4, black_friday_visibility).
   • These should mirror the structure of your main fields and be in the same metadata section.
     
     

{

  "id": "coffee_machine",

  "facets": {

    "price": 10,

    "price_october_campaign": 5

  }

}

1. Configure override rules
   
   

   • Use the Metadata Override APIs to tell Constructor when to swap fields.
   • Example: from Oct 1st 9pm UTC until Oct 7th 11:59pm UTC, use price_october_campaign instead of price.
     
     

{

  "field_name": "price",

  "field_path_in_metadata": "facets.price",

  "rules": [

    {

      "start_time": "2025-10-01T21:00:00Z",

      "end_time": "2025-10-07T23:59:59Z",

      "replaced_field_name": "price_october_campaign",

      "replaced_field_path_in_metadata": "facets.price_october_campaign"

    }

  ]

}

1. Constructor takes care of the rest

   • During the configured window, all API responses will return the override value.
   • Once the window expires, the original value is automatically restored.
     
     

🔗 API Reference

• Summary page Metadata Overrides
• GET Metadata Overrides 
• POST Metadata Override 
• PATCH Metadata Override 
• DELETE Metadata Override 

ℹ️ Limitations / Information to note

• Supports Search, Browse and Autosuggest for now, Recommendation support is coming soon.
• Up to 5 override rules per catalog key.
• Only one active override per field per time window.
• Overrideable fields need to be ingested and configured at least a week before the campaign start date.
• If an override field is missing for an item, the system will return the original field value.
• Start & end time values must be formatted as an ISO date & time string, with a timezone UTC offset at the end (yyyy-MM-dd hh:mm:ss.SSS±hh:mm). An entry with a missing timezone specification is assumed to be UTC.

✅ What to do next

• Start including override fields (e.g. price_october_campaign, promo_price_q4, etc.) in your feeds now.
• Configure rules via the new Metadata Overrides APIs.

• Once configured, you can test results using the `now` parameter. It allows you to override the desired time with a specific timestamp.

  • For example, to search for "cookies" and see the results as if the query was being executed on May first at one minute past midnight:

    • https://ac.cnstrc.com/search/cookies?key=[API key]&now=1651388460
    • The now parameter requires a Unix epoch timestamp
    • This query requires an API token in addition to an API key
    • Setting a now parameter can only be set to future times
• Rules will come into effect automatically at the exact times you need.
  
  

👉 This feature removes the headache of timing ingestions and gives you reliable control over campaign/sales related changes.