> 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/manage-improve-product-data/rules-bulk-edit-and-enrich/how-to-use-actions-then-in-rules/text-actions/rule-action-search-for-value.md).

# Search for value

Find listed values in a field and save matching or replacement values to another field.

Use **`Search for value`** to find a value in one field and save the matching or replacement value in another field.

This action is useful for tasks such as:

* Extracting a color, brand, or size from a larger text field.
* Standardizing a found value before you export it.

### When to use this action

Use this action when your source and destination are different fields. Use **`Search for and replace with supported value`** to map complete values in the same field from a supported list. Use **`Replace value`** to replace text within the same field.

### Add search and replacement values

In **Search for value in (part of) field**, enter each value you want to find on a separate line.

Use **Use replacement value** when you want to save a different value. Enter each replacement on the line that matches its search value. For example, enter `navy` on the first line and `blue` on the first replacement line.

Leave **Use replacement value** empty to save the value that the action finds.

***

## Example `Search for value` use cases

### Extract a color from product descriptions

#### How to build the rule

* Condition: **`For all items`**
* Action: THEN **`Search for value`** in `description` and replace in `color`

### Extract brands from titles

#### How to build the rule

* Condition: **`For all items`**
* Action: THEN **`Search for value`** in `title` and replace in `brand`

{% hint style="info" %}

#### Tip

When you search a list field, the action checks every list value. Empty lists remain empty. Convert the list to text before searching it when you need a text result.
{% endhint %}


---

# 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/manage-improve-product-data/rules-bulk-edit-and-enrich/how-to-use-actions-then-in-rules/text-actions/rule-action-search-for-value.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.
