Appearance
Changelog: August 2025
General
Added
- Exposed the Relewise API & SDKs as an MCP Server. This allows you to use AI to help write your Relewise integration code and answer questions from documentation.
API
Added
- Added new User Condition:
HasCompanyDataCondition
. The condition can be used in merchandising and triggers to limit them to target users belonging to companies that have specific data associated with them. For example, you can make a merchandising rule that boosts products with a great profit margin if the user is associated with a company marked as "High Spender."
Changed
- Changed the logic behind personalization when using
ProductRelevanceSorting
in a search request. It now personalizes a more consistent number of products regardless of what filters or facets are used in the request. This should be especially noticeable in PLPs.
Fixed
- [Search] Fixed a bug in
DataObjectFacets
withEvaluationMode.Or
that could lead to theAvailable
values collection being empty. - [Search] Fixed a bug in the search index engine that prevented products and content from being found based on their category's
DataValue
. - [Search] Fixed a bug where searching for multiple data values (e.g., colors) in any order could miss valid variants. Results now include all matching combinations, regardless of input order.
- [Search] Fixed cases where not all variants were evaluated as candidates for search results.
- Fixed an issue where tracking a
Cart
withCartName
set tonull
was possible. It now convertsnull
values to the standarddefault
instead. - Retail Media Analytics: Selecting an upper bound in the future will now only return entries with an upper bound of today’s date.
- Retail Media: Fixed an issue where a campaign would not receive the Inactive status when its associated advertiser was set as Inactive.
- Fixed an issue with Similar Products recommendations when evaluating multilingual collections between products, where a product was missing one or more multilingual data points.
My Relewise
Added
- Added Dutch support to regional settings, enabling number and date formatting according to Dutch conventions.
- Merchandising: Added support for targeting a user's company data via User Conditions. You can read more here.
Changed
- Entities (e.g., Products and Categories) are now automatically reloaded when currency or language is changed.
Fixed
- Search Index: Fixed an issue that allowed copying an index to inactive datasets.
Integration
Added
- Demo Shop: Added a component to subscribe to a demo newsletter. Doing so will update the user with the email from the input field.
- Demo Shop: Added support for search highlighting on Product and Content entities. This feature is toggleable in settings.
- Java SDK: Added support for setting an evaluation mode on object facets.
- JS SDK: Added an option when creating a client to override the default
cache
mode for fetch. - JS SDK: Added support for setting an evaluation mode on object facets.
- PHP SDK: Added clarifying remarks and references to parameters in the PHPDoc.
- PHP SDK: Added support for setting an evaluation mode on object facets.
- Shopify Theme App: Exposed a global object with a function to fetch a user. You can read more here.
- Shopify Theme App: Added a block for the Personal Products recommendation.
- Shopify Theme App: Added support for the Recently Viewed Products recommendation.
- Web Components: Added support for Relevance Modifiers. Modifiers are also supported by targeting features, so you can choose to apply certain modifiers only to targeted components.
- Web Components: Added support for the Personal Products recommendation.
- Web Components: Added support for the Recently Viewed Products recommendation.
- Web Components: Added the option to render "nothing" when overriding a template.
Changed
- .NET SDK: The
Brand
constructor now initializes theData
andAssortments
properties by default. This ensures consistency with how other entity classes are initialized in the .NET SDK. - Java SDK: The
HttpClient
used for making requests is now only initialized once per client type. - PHP SDK: The SDK now reuses cURL handles so that connections remain open when multiple consecutive requests are posted.
- Shopify App: Upgraded to the latest Shopify app framework.
Fixed
- JS SDK: Fixed an issue where the integrator batch function was using incorrect return types.
- JS SDK: Fixed an issue where building Category paths required a display name unnecessarily.
- PHP SDK: Fixed an issue where product data object facets would not yield results.
- PHP SDK: Fixed an issue where some objects were not assigned values when mapped from API responses.
- Shopify App: Fixed an issue where syncing product data in stores with many translations for metafields sometimes caused throttling against the Shopify API.
- Shopify Theme App: Fixed an issue where, when using Usercentrics as a consent provider, users were sometimes tracked anonymously before Usercentrics was initialized, even after giving consent.
- Shopify Theme App: Fixed an issue that rendered an "error" tile when the native product card could not find the right product.
Documentation
Added
- Added clarification to AllowReplacingOfRecentlyShownRecommendations and PrioritizeDiversityBetweenRequests recommendation settings, specifying that they do not influence how fill-results are chosen.
- Added documentation for
UserHasCompanyDataUserCondition
. Available here. - Removed the statement that our Shopify app only supports certain themes and added a section describing the prerequisites for the search overlay to work.
Changed
- Updated the match type descriptions on the Search Index page to better explain their use.