Controls Utilities Bundle v1.0.3 - Bugfix

Release

Author:

Holger Lierse

Changed on:

4 Sept 2026

Target release date:	2026-09-04
Release status:	Released

Description

Incremental patch release for `utils-controls`

Changelog

Fixed position-level controls being silently skipped. The product ref filter passed to the controls query was JSON-quoted (`"productRef%"`) instead of a plain string (`productRef%`), so no position or variant controls ever matched.

Released capability depth:	Enhancement
Release bundle / Capability type:	Tool

Related content

Controls Utilities

Edited 2 days ago

`util-controls` is a helper library called from a Rule. Given a position, it resolves the controls that apply to that position - both group-level (bulk) controls and position/product/variant-level controls - and applies them in a defined order to produce an updated position, along with an audit trail of every change.The library removes the need to hand-write control resolution logic in each rule: a single call to `ControlUtils.applyControls(...)` loads the required data from GraphQL, evaluates the controls, and returns the result.

Controls Utilities Overview

Edited 11 days ago

The Controls Utilities library (`util-controls`) applies controls to a catalog position in a consistent, reusable way. Rather than each rule reimplementing how to find and apply controls, a rule calls `ControlUtils.applyControls(...)`, which loads the required data from GraphQL, evaluates the applicable controls, and returns an updated position together with an audit of every change.

How Controls Utilities work

Edited 13 days ago

The articles walks you through the Controls Utilities bundle (`util-controls`): a library that applies controls to catalog positions from within a Rule, so that inclusion, exclusion, buffer, limit and threshold logic is resolved and applied the same way everywhere it is used.Prerequisites

Basic understanding of the Utility Bundles
Familiarity with writing Rules using the Rules SDK
Completion of the Getting Started with the Utility Bundles guide

Copyright © 2024-2026 Fluent Retail Pty Ltd (trading as Fluent Commerce). Unless otherwise expressly stated in a current written agreement with Fluent Commerce or any of its affiliates or on any single page of the docs.fluentcommerce.com site, use of the materials on this site is strictly limited to viewing by individuals over 18 years old for legitimate commercially appropriate reasons; and any downloading, copying or other actions or uses of any kind or by any means of the materials on this site, including by artificial intelligence tools, is strictly prohibited. All other rights reserved.