Relewise Documentation

Appearance

Changelog: October 2026 ​

Highlights of the Month ​

Agent Gateway ​

Agent Gateway is now out of beta. Connect AI assistants to Relewise to analyze performance, inspect catalog data, and manage supported settings using your existing permissions. Read more here.

OAuth 2.0 Client Credentials ​

Connect backend systems to Relewise using access tokens that expire automatically. Manage credentials and permissions in My Relewise, with support across SDKs. Read more here.

Context Values ​

Tailor merchandising to each situation, such as a campaign, device type, or Shopify page. Context Values let you control when rules apply to searches and recommendations. Read more here.

Retail Media in Shopify ​

Bring sponsored Products and Display Ads to Shopify search results and Collection pages. Choose where promotions appear and manage campaigns through My Relewise. Read more here.

Daily search conversion rates ​

See how search conversion rates change day by day, both overall and for individual search terms. Use the charts to understand trends and investigate changes. Read more here.

API ​

Added ​

  • Search Index: We now detect update batches and start indexing after the batch is finished to reduce the time it takes for final changes to be fully available via the index.
  • Search Analytics: Added daily conversion rates to aggregate and per-term search analytics. How search conversions are measured.

Changed ​

  • Search Index: The index is now marked as stale only when fields included in it change, helping relevant changes appear sooner.

Fixed ​

  • Filters: Improved filter processing to reduce filter update delay after Product updates.
  • Retail Media: Fixed an issue where eligible Display Ads could be missing from search results.
  • Search: Fixed an issue where the index could incorrectly report that it was up to date when model updates arrived during a rebuild. This also improves accuracy of the last and current stale durations for an index. See Stale Data.

My Relewise ​

Added ​

  • Agent Gateway: Released Agent Gateway from beta, letting connected AI assistants and external tools work with supported Relewise capabilities using your My Relewise permissions. Get started with Agent Gateway.
  • Added the ability to sort Triggers under Marketing Automation > Trigger Configuration.
  • API Credentials: Added support for managing OAuth 2.0 Client Credentials for backend integrations, with setup and authentication guidance. The API Reference now supports API Key or Bearer token request examples.
  • Live View: Updated the design to make request details easier to inspect, including effective Context Values and individual requests within batches. Inspect requests in Live View.
  • Merchandising: Added Context Values, which are string Key/value pairs included in a Search or Recommendation API request. They describe the context of that request so that merchandising rules can apply to a particular campaign, device type, or other situation. Read about Context Values.
  • Search Analytics: Added daily conversion-rate charts to the overview and individual term details. Agent Gateway also exposes daily overview conversion rates through REST, MCP, and Ask AI. Search conversions.
  • Variant Details: Added Variant-specific order counts, total views, creation time, last purchase, and last view in My Relewise. Integrations can also retrieve these Variant statistics.

Changed ​

  • Improved the mobile and tablet navigation layout.
  • Integrations: Added metrics for the number of Users on the Dataset.
  • Merchandising, Retail Media, Search: Data Key selectors now use Entity Key metadata instead of sampled entities, helping users find relevant Keys when configuring rules and filters.

Fixed ​

  • Retail Media: Fixed an issue where Product searches that requested Retail Media but returned no promoted Products or Display Ads were missing from Live View and not counted as Retail Media requests. Inspect requests in Live View.

Integration ​

Added ​

  • .NET SDK Extensions: Added support for OAuth 2.0 Client Credentials for all clients, configurable through code or configuration files with per-client and named overrides. .NET authentication.
  • .NET SDK: Added support for OAuth 2.0 Client Credentials. Read about authentication methods.
  • Java SDK: Added support for OAuth 2.0 Client Credentials. Read about authentication methods.
  • Java SDK: Added support for sending Context Values with Search and Recommendation requests to apply merchandising rules to specific requests.
  • JavaScript SDK: Added support for OAuth 2.0 Client Credentials. Read about authentication methods.
  • JavaScript SDK: Added support for sending Context Values with Search and Recommendation requests to apply merchandising rules to specific requests.
  • PHP SDK: Added support for OAuth 2.0 Client Credentials. Read about authentication methods.
  • Shopify App: Added configurable headings to storefront recommendation blocks. Headings are hidden when no recommendations are available. Read more.
  • Shopify App: Added Page ID and Collection ID Context Values to storefront Recommendation requests, allowing precise merchandising targeting. Read about Shopify Context Values.
  • Shopify App: Added support for Retail Media. Read more here.
  • Shopify App: Added a Filter by current collection option to supported Product recommendation blocks, so recommendations on collection pages are limited to Products in the Collection being viewed. Read more..
  • Umbraco: Added a package setting to use stable GUIDs as Content IDs, helping Content match across local and live environments. Read more here.
  • Umbraco: Added support for Tiptap rich text Content. Umbraco 16 removed the TinyMCE option from the Rich Text Editor.
  • Web Components: Added an optional heading slot to all recommendation web components, allowing custom titles.
  • Web Components: Added support for Retail Media in Universal Search and Product Search. Read more here.
  • Web Components: Added support for sending Context Values with Search and Recommendation requests to apply merchandising rules to specific requests.

Changed ​

  • Blazor Apps (API Explorer): Updated the design for a more consistent experience, fewer clicks, side-by-side results in the Request Explorer, and better performance.
  • PHP SDK: Updated to support API version 1.320.0, including Context Values for targeting merchandising rules in Search and Recommendation requests, plus additional Variant statistics and timestamps. Learn more about Context Values.

Fixed ​

  • PHP SDK: Fixed deprecation warnings caused by calls to curl_close() in PHP 8.5.
  • Shopify App: Fixed a bug that prevented the Shopify App from tracking views on blog posts.
  • Shopify App: Fixed a bug that caused recommendation widgets to render empty when Variant-aware Product card rendering was enabled and Variant resolution metadata was missing.

Security ​

  • Shopify App: Fixed handling of special characters in Product IDs and SKUs used by storefront recommendation blocks.
  • Web Components: Fixed a security issue where stripping HTML could trigger resource requests, event handlers, or custom element construction while extracting text.

Documentation ​

Added ​

  • Added a How-To guide for creating Pin Merchandising Rules. Read more here.
  • Added links to guides for merchandising email recommendations created with the Relewise HTML Generator. Read more here.

Changed ​

  • Search: Clarified the ContainsCondition documentation to explain String and StringList matching, All/Any behavior, empty lists, and how value evaluation differs from MustMatchAllConditions.

Don't know us? Don't worry - you can find more information about us, by visiting our main page www.relewise.com

ContactChangelogsCookies, Privacy & TermsAPI Reference