> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/changelog/2026/october/rules-are-now-easier-to-understand.md).

# Rules are now easier to understand

We've simplified the wording of our rules to make them easier to understand and use.

{% hint style="info" %}

#### We're rolling out this feature gradually

Selected users, and all agency users, can use simplified wording when creating and editing rules. Other users continue to see technical wording.
{% endhint %}

### What's new

Up until now, Channable's rules have been worded in quite a technical way. As part of our ongoing efforts to improve the user experience, we've simplified the language of rules.

This change makes it easier for you to create rules.

### What will I see?

If you've been selected to try out the new rules, or if you have an agency account, you see the following banner when working in **Rules**: ‘We've simplified the wording of our rules to make them easier to understand and use.’

<div data-with-frame="true"><figure><img src="https://199992526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCelgbro04804WOVz6ZV0%2Fuploads%2Fq3tpNqmQAKaoIvk1nEn5%2FScreenshot%202026-10-08%20at%2010.05.23.png?alt=media&amp;token=81cc5aa7-0ddb-417a-befd-a0ee4b257a5e" alt=""><figcaption></figcaption></figure></div>

When viewing an existing rule, or setting up a new one, you will see the simplified wording.

#### Switch back to technical text

You can switch back to technical wording at any time. Use the [searchable glossary of rules](#rule-wording-glossary) to compare the wording.

In **Rules**, click **Switch to technical text**.

{% hint style="info" %}

#### This is a cosmetic change only.

The setup of your rules is not affected by the simplified wording.

* Existing rules will continue to work exactly as before.
* New rules will work exactly as they would if you used the technical wording.
  {% endhint %}

{% hint style="warning" %}

#### Simplified wording will eventually apply to all users

You can switch back to technical text until simplified wording is enforced for all users.
{% endhint %}

### Rule wording glossary

Use [condition changes](#condition-changes) to compare conditions. Use [action name changes](#action-name-changes) to compare action names. Use [action phrasing examples](#action-phrasing-examples) to compare complete rules.

#### Condition name changes

Use this table to find the simplified wording for a technical condition.

Use the search bar to find a specific condition in the table.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Technical phrasing</th><th>Simplified phrasing</th></tr></thead><tbody><tr><td><code>All</code></td><td><code>For all items</code></td></tr><tr><td><code>Equals any of</code></td><td><code>Exactly matches any</code></td></tr><tr><td><code>Is in highest X</code></td><td><code>Is in top</code></td></tr><tr><td><code>Is in lowest X</code></td><td><code>Is in bottom</code></td></tr><tr><td><code>Is not valid</code></td><td><code>Is not a valid GTIN number</code></td></tr><tr><td><code>Length exceeds</code></td><td><code>Has more characters than</code></td></tr><tr><td><code>Length doesn't exceed</code></td><td><code>Has less characters than</code></td></tr><tr><td><code>Word count exceeds</code></td><td><code>Has more words than</code></td></tr><tr><td><code>Word count doesn't exceed</code></td><td><code>Has exactly or less words than</code></td></tr></tbody></table>

#### Action name changes

Use this table to compare technical and simplified action names. The examples show each action name.

Use the search bar to find a specific action in the table.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Technical phrasing</th><th>Simplified phrasing</th></tr></thead><tbody><tr><td><code>&#x3C;add google tracking></code></td><td><code>&#x3C;add google tracking></code></td></tr><tr><td><code>&#x3C;append value></code></td><td><code>&#x3C;add text></code></td></tr><tr><td><code>&#x3C;build item group></code></td><td><code>&#x3C;build item group></code></td></tr><tr><td><code>&#x3C;combine value></code></td><td><code>&#x3C;build value></code></td></tr><tr><td><code>&#x3C;calculate></code></td><td><code>&#x3C;calculate></code></td></tr><tr><td><code>&#x3C;calculate date></code></td><td><code>&#x3C;calculate date></code></td></tr><tr><td><code>&#x3C;calculate date interval></code></td><td><code>&#x3C;calculate date interval></code></td></tr><tr><td><code>&#x3C;calculate formula></code></td><td><code>&#x3C;calculate formula></code></td></tr><tr><td><code>&#x3C;calculate item group></code></td><td><code>&#x3C;calculate item group></code></td></tr><tr><td><code>&#x3C;calculate length></code></td><td><code>&#x3C;calculate length></code></td></tr><tr><td><code>&#x3C;calculate list length></code></td><td><code>&#x3C;calculate list length></code></td></tr><tr><td><code>&#x3C;calculate sum></code></td><td><code>&#x3C;calculate sum></code></td></tr><tr><td><code>&#x3C;copy value></code></td><td><code>&#x3C;copy value></code></td></tr><tr><td><code>&#x3C;exclude></code></td><td><code>&#x3C;exclude item(s)></code></td></tr><tr><td><code>&#x3C;group items></code></td><td><code>&#x3C;group items together></code></td></tr><tr><td><code>&#x3C;join list to text></code></td><td><code>&#x3C;join list to text></code></td></tr><tr><td><code>&#x3C;maximum length></code></td><td><code>&#x3C;trim text></code></td></tr><tr><td><code>&#x3C;modify text></code></td><td><code>&#x3C;modify text></code></td></tr><tr><td><code>&#x3C;reformat number></code></td><td><code>&#x3C;reformat number></code></td></tr><tr><td><code>&#x3C;remove duplicate items></code></td><td><code>&#x3C;remove duplicate products></code></td></tr><tr><td><code>&#x3C;remove duplicates from list></code></td><td><code>&#x3C;remove duplicates from list></code></td></tr><tr><td><code>&#x3C;replace value></code></td><td><code>&#x3C;replace value></code></td></tr><tr><td><code>&#x3C;round number></code></td><td><code>&#x3C;round number></code></td></tr><tr><td><code>&#x3C;search and replace value></code></td><td><code>&#x3C;search for and replace with> &#x3C;supported value></code></td></tr><tr><td><code>&#x3C;search for value></code></td><td><code>&#x3C;search for value></code></td></tr><tr><td><code>&#x3C;search in list></code> > <code>&#x3C;count value></code></td><td><code>&#x3C;count occurrences in list></code></td></tr><tr><td><code>&#x3C;search in list></code> > <code>&#x3C;search value and delete></code></td><td><code>&#x3C;delete value from list></code></td></tr><tr><td><code>&#x3C;search in list></code> > <code>&#x3C;search value and delete others></code></td><td><code>&#x3C;delete other values from list></code></td></tr><tr><td><code>&#x3C;set to value></code></td><td><code>&#x3C;set value></code></td></tr><tr><td><code>&#x3C;slice list></code></td><td><code>&#x3C;select list range></code></td></tr><tr><td><code>&#x3C;sort list></code></td><td><code>&#x3C;sort list></code></td></tr><tr><td><code>&#x3C;split items></code></td><td><code>&#x3C;split list into items></code></td></tr><tr><td><code>&#x3C;split text></code></td><td><code>&#x3C;split text></code></td></tr><tr><td><code>&#x3C;split text to list></code></td><td><code>&#x3C;split text into list></code></td></tr></tbody></table>

#### Action phrasing examples

The first column shows the simplified action name. The second and third columns show each action in a rule.

Use the search bar to find a specific action in the table.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Simplified phrasing</th><th>Technical phrasing example</th><th>Simplified phrasing example</th></tr></thead><tbody><tr><td>Add Google tracking</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;add google tracking></code></td><td>Then <code>&#x3C;add google tracking></code> to <code>&#x3C;field></code>.<br><br>Enter custom values for <strong>Source</strong>, <strong>Medium</strong>, <strong>Campaign</strong>, <strong>Term</strong>, and <strong>Content</strong>.</td></tr><tr><td>Add text</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;append value></code> <code>&#x3C;custom field entry></code></td><td>Then <code>&#x3C;add text></code> <code>&#x3C;custom field></code> at the end of <code>&#x3C;field></code></td></tr><tr><td>Build item group</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;build item group></code></td><td>Then <code>&#x3C;build item group></code> based on <code>&#x3C;field></code></td></tr><tr><td>Build value</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;combine value></code> <code>&#x3C;custom field entry></code></td><td>Then <code>&#x3C;build value></code> <code>&#x3C;custom field entry></code> and store in <code>&#x3C;field></code></td></tr><tr><td>Calculate</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;calculate></code> take <code>&#x3C;field></code> <code>&#x3C;operator></code></td><td>Then <code>&#x3C;calculate></code> <code>&#x3C;field></code> <code>&#x3C;operator></code> and store in <code>&#x3C;field></code>.<br><br>Choose <strong>Multiply by</strong>, <strong>Divide by</strong>, <strong>Plus</strong>, <strong>Minus</strong>, <strong>Multiply by field</strong>, <strong>Divide by field</strong>, <strong>Plus field</strong>, or <strong>Minus field</strong>.</td></tr><tr><td>Calculate date</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;calculate date></code> take <code>&#x3C;field></code> <code>&#x3C;operator></code> <code>&#x3C;value></code> <code>&#x3C;unit></code></td><td>Then <code>&#x3C;calculate date></code> calculate <code>&#x3C;field></code> <code>&#x3C;operator></code> <code>&#x3C;value></code> <code>&#x3C;unit></code> and store in <code>&#x3C;field></code>.<br><br>Choose <strong>Plus</strong>, <strong>Minus</strong>, <strong>Plus field</strong>, or <strong>Minus field</strong>.<br><br>Use <strong>Seconds</strong>, <strong>Minutes</strong>, <strong>Hours</strong>, <strong>Days</strong>, or <strong>Weeks</strong>.</td></tr><tr><td>Calculate date interval</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;calculate date interval></code> find difference between <code>&#x3C;field></code> and <code>&#x3C;field></code> in <code>&#x3C;unit></code></td><td>Then <code>&#x3C;calculate date interval></code> between <code>&#x3C;field></code> and <code>&#x3C;field></code> in <code>&#x3C;unit></code> and store in <code>&#x3C;field></code>.<br><br>Use <strong>Seconds</strong>, <strong>Minutes</strong>, <strong>Hours</strong>, <strong>Days</strong>, or <strong>Weeks</strong>.</td></tr><tr><td>Calculate formula</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;calculate formula></code> <code>&#x3C;custom field value></code></td><td>Then <code>&#x3C;calculate formula></code> <code>&#x3C;custom field value></code> and store in <code>&#x3C;field></code>.</td></tr><tr><td>Calculate item group</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;calculate item group></code> <code>&#x3C;count items/calculate sum/find lowest value/find highest value></code> store in <code>&#x3C;field></code></td><td>Then <code>&#x3C;calculate item group></code> in <code>&#x3C;field></code> <code>&#x3C;count items></code>, or <code>&#x3C;calculate sum></code>, <code>&#x3C;find lowest value></code>, or <code>&#x3C;find highest value></code> of <code>&#x3C;field></code> and store in <code>&#x3C;field></code>.<br><br>Select <strong>Sort numbers</strong> for lowest or highest values.</td></tr><tr><td>Calculate length</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;calculate length></code> of field <code>&#x3C;field></code></td><td>Then <code>&#x3C;calculate length></code> of <code>&#x3C;field></code> and store in <code>&#x3C;field></code>.</td></tr><tr><td>Calculate list length</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;calculate list length></code> of <code>&#x3C;field></code></td><td>Then <code>&#x3C;calculate list length></code> of <code>&#x3C;field></code> and store in <code>&#x3C;field></code>. Select <strong>Unique only</strong> when needed.</td></tr><tr><td>Calculate sum</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;calculate sum></code> of field <code>&#x3C;field></code></td><td>Then <code>&#x3C;calculate sum></code> of <code>&#x3C;field></code> and store in <code>&#x3C;field></code>.</td></tr><tr><td>Copy value</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;copy value></code> from <code>&#x3C;field></code></td><td>Then <code>&#x3C;copy value></code> from <code>&#x3C;field></code> and store in <code>&#x3C;field></code>.</td></tr><tr><td>Count occurrences in list</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;search in list></code> <code>&#x3C;count value></code> <code>&#x3C;field/custom field entry></code> store in <code>&#x3C;field></code></td><td>Then <code>&#x3C;count occurrences in list></code>. Search for <code>&#x3C;field/custom field entry></code>, count values in <code>&#x3C;field></code>, and store in <code>&#x3C;field></code>.</td></tr><tr><td>Delete other values from list</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;search in list></code> <code>&#x3C;search value and delete others></code> <code>&#x3C;field/custom field entry></code></td><td>Then <code>&#x3C;delete other values from list></code>. Keep <code>&#x3C;field/custom field entry></code> and delete other values from <code>&#x3C;field></code>.</td></tr><tr><td>Delete value from list</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;search in list></code> <code>&#x3C;search value and delete></code> <code>&#x3C;field/custom field entry></code></td><td>Then <code>&#x3C;delete value from list></code>. Delete <code>&#x3C;field/custom field entry></code> from <code>&#x3C;field></code>.</td></tr><tr><td>Exclude item(s)</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;exclude></code></td><td>Then <code>&#x3C;exclude item(s)></code></td></tr><tr><td>Group items together</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;group items></code></td><td>Then <code>&#x3C;group items together></code> and store resulting value in <code>&#x3C;field></code></td></tr><tr><td>Join list to text</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;join list to text></code> join with <code>&#x3C;custom field entry></code></td><td>Then <code>&#x3C;join list to text></code> of <code>&#x3C;custom field entry></code> and store in <code>&#x3C;field></code>.</td></tr><tr><td>Modify text</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;modify text></code> <code>&#x3C;option></code></td><td><p>Then <code>&#x3C;modify text></code> of <code>&#x3C;field></code>: <code>&#x3C;option></code>.</p><p>Options: <strong>Capitalize only first character</strong>, <strong>Capitalize first character per word</strong>, <strong>Capitalize first character by sentence</strong>, <strong>Lowercase all words</strong>, <strong>Uppercase all words</strong>, <strong>Remove all non-numeric characters</strong>, <strong>Remove digits</strong>, <strong>Remove linebreaks</strong>, <strong>Remove uncecessary whitespaces</strong>, and <strong>Remove HTML from text</strong>.</p></td></tr><tr><td>Reformat number</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;reformat number></code></td><td><p>Then <code>&#x3C;reformat number></code> of <code>&#x3C;field></code>.</p><p>Choose a <strong>Decimal separator</strong> and <strong>Thousands separator</strong> of <code>,</code> or <code>.</code>, then select <strong>No rounding</strong> or <strong>0 decimals</strong> through <strong>6 decimals</strong>.</p></td></tr><tr><td>Remove duplicate products</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;remove duplicate items></code> <code>&#x3C;exclude duplicates/keep lowest/keep highest></code></td><td><p>Then <code>&#x3C;remove duplicate products></code> based on <code>&#x3C;field></code>.</p><p>To retain one item, choose <code>&#x3C;keep lowest></code> or <code>&#x3C;keep highest></code> of field <code>&#x3C;field></code> and sort <code>&#x3C;alphabetically/numerically></code>.</p></td></tr><tr><td>Remove duplicates from list</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;remove duplicates from list></code></td><td>Then <code>&#x3C;remove duplicates from list></code> in <code>&#x3C;field></code>.</td></tr><tr><td>Replace value</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;replace value></code> of <code>&#x3C;field/custom field value></code> replace with <code>&#x3C;field/custom field value></code></td><td><p>Then <code>&#x3C;replace value></code> of <code>&#x3C;field/custom field value></code> replace with <code>&#x3C;field/custom field value></code> in <code>&#x3C;field></code>.</p><p>Select <strong>Case sensitive</strong> or <strong>Use regex</strong> when needed.</p></td></tr><tr><td>Round number</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;round number></code> calculate <code>&#x3C;closest/up/down></code> to <code>&#x3C;value></code></td><td><p>Then <code>&#x3C;round number></code> of <code>&#x3C;field></code>.</p><p>Round to <strong>Closest</strong>, <strong>Up</strong>, or <strong>Down</strong>: <code>1</code>, <code>5</code>, <code>10</code>, <code>25</code>, <code>95</code>, <code>99</code>, or <strong>Whole number</strong>.</p></td></tr><tr><td>Search for and replace with supported value</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;search and replace value></code>. <strong>Field value</strong> and <strong>Supported value</strong> are entered in a table.</td><td><p>Then <code>&#x3C;search for and replace with supported value></code> in <code>&#x3C;field></code>.</p><p>Enter <strong>Field value</strong> and <strong>Supported value</strong> in the table, click <strong>Auto-fill field values</strong> when needed, and select <strong>Case sensitive</strong> or <strong>Exact match</strong> under <strong>More options</strong>.</p></td></tr><tr><td>Search for value</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;search for value></code> in <code>&#x3C;field></code>. <strong>Search for value in (part of) field:</strong> Enter one value per line. <strong>Use replacement value:</strong> Enter one value per line.</td><td><p>Then <code>&#x3C;search for value></code> in <code>&#x3C;field></code> and replace in <code>&#x3C;field></code>.</p><p><strong>Search for value in (part of) field:</strong> Enter one value per line. <strong>Use replacement value:</strong> Enter one value per line.</p></td></tr><tr><td>Select list range</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;slice list></code> from <code>&#x3C;field></code> use <code>&#x3C;position></code> until <code>&#x3C;position></code></td><td><p>Then <code>&#x3C;select list range></code> between <code>&#x3C;position></code> and <code>&#x3C;position></code> from <code>&#x3C;field></code> and store in <code>&#x3C;field></code>.</p><p>Positions include <strong>First</strong> through <strong>Twentieth from the beginning</strong>, and <strong>Last</strong> through <strong>Twentieth last from the end</strong>.</p></td></tr><tr><td>Set value</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;set to value></code> <code>&#x3C;custom field entry></code></td><td>Then <code>&#x3C;set value></code> of <code>&#x3C;field></code> to <code>&#x3C;custom field entry></code></td></tr><tr><td>Sort list</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;sort list></code> order <code>&#x3C;descending/ascending></code></td><td><p>Then <code>&#x3C;sort list></code> of <code>&#x3C;field></code> in <code>&#x3C;descending/ascending></code> order.</p><p>Select <strong>Sort numbers</strong> when needed.</p></td></tr><tr><td>Split list into items</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;split items></code></td><td>Then <code>&#x3C;split list into items></code> Field to split on: <code>&#x3C;field></code></td></tr><tr><td>Split text</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;split text></code> from <code>&#x3C;field></code> split on <code>&#x3C;custom field entry></code> use <code>&#x3C;position></code> until <code>&#x3C;position></code></td><td><p>Then <code>&#x3C;split text></code> in <code>&#x3C;field></code>. Split on <code>&#x3C;custom field value></code>, keep <code>&#x3C;position></code> until <code>&#x3C;position></code>, and store in <code>&#x3C;field></code>.</p><p>Select <strong>Case sensitive</strong> when needed.</p></td></tr><tr><td>Split text into list</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;split text to list></code> split on <code>&#x3C;custom field entry></code></td><td>Then <code>&#x3C;split text into list></code> split on <code>&#x3C;custom field entry></code> and store in <code>&#x3C;field></code>.</td></tr><tr><td>Trim text</td><td>Then take <code>&#x3C;field></code> and <code>&#x3C;maximum length></code> of <code>&#x3C;custom field entry></code> characters and <code>&#x3C;trim on words/trim directly></code></td><td>Then <code>&#x3C;trim text></code> of <code>&#x3C;field></code>. Limit to <code>&#x3C;custom field entry></code> characters and select <code>&#x3C;trim on words/trim directly></code>.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.channable.com/changelog/2026/october/rules-are-now-easier-to-understand.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
