# How to use AI generated text

> **Who can use this feature:** \
> You need the **Core Pro** plan in your [Channable subscription](/account-billing/manage-your-subscription/channables-pricing-plans.md) to use this feature.

{% columns %}
{% column width="58.333333333333336%" %}

### **What is AI generated text?**

**AI generated texts** are AI-enhanced texts that you can generate in the **Optimize** section of Channable. 

With the AI generated text generator, you can adjust your item titles, descriptions, or other text fields in bulk to create high-performing texts for your listings in one workflow. 

You can select fields from your product data like `category`, `brand`, `color` or `size`  that your generator will reference to generate suggestions.
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/pQuhJTV2JeSps8u628Sc" alt="" width="563"><figcaption></figcaption></figure>

{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
**Example:**

You could set your generator to optimize a title using data from your `description` field (e.g. from “*Urban Explorer Cargo Joggers*” to “*Men’s Urban Cargo Joggers - Durable Streetwear & Casual Pants*”)
{% endhint %}

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Before you start

**You'll need**

* [A Gemini connection](/manage-improve-product-data/optimize-attributes-with-ai/how-to-use-ai-generated-text/how-to-create-a-gemini-connection.md) or [OpenAI connection](/manage-improve-product-data/optimize-attributes-with-ai/how-to-use-ai-generated-text/how-to-create-an-openai-connection.md) set up in Channable

{% hint style="info" %}
**Note:** You can use a trial Gemini connection to test AI Text Generation if you don't have a Gemini or OpenAI account yet. A test connection is limited to one generator per project, and you can only generate up to 10 texts.
{% endhint %}

**Good to know**

* **Token usage:** [Gemini](/manage-improve-product-data/optimize-attributes-with-ai/how-to-use-ai-generated-text/how-to-create-a-gemini-connection.md) or [OpenAI ](/manage-improve-product-data/optimize-attributes-with-ai/how-to-use-ai-generated-text/how-to-create-an-openai-connection.md)tokens will be used in the **Prompting** and **Generate values** steps. Monitor your usage to control costs.
  * [Token costs for Gemini 3.1 Flash-Lite](https://ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-lite)
  * [Token costs for OpenAI GPT-5.4 Nano ](https://developers.openai.com/api/docs/pricing)
* **Generation and approval costs:** You are charged when texts are generated, regardless of whether you approve them or not.
* **Re-run costs:** Every re-run is treated as a new request. Each one adds a new cost.
* **Total cost:** The total cost depends on the amount of input data, prompt and output length, and the number of items text is being generated for. You can find the **Estimated generation cost** in the **Prompting** step.
* **Already have one or more AI text generators set up?**  If a generator later in the list uses the same save fields for the same items, it will override the generators that run before it. You can drag and drop to reorder the list.

***

{% stepper %}
{% step %}

### Create your generator

1. Go to **\[your company] > \[your project] > Optimize**.
2. Click **+ Generate text with AI** to start the setup.
3. In the pop up, select the type of content that you want to create. The content type you select defines the prompt template that you will work with in the Prompting step.

   * **Titles:** Generate AI text suggestions to improve product titles.
   * **Descriptions:** Generate AI text suggestions to improve product descriptions.
   * **Free text:** Generate AI text suggestions for specific text fields.

   <figure><img src="/files/0aOgwT2F1n0M3d5tA0No" alt=""><figcaption></figcaption></figure>
4. Click **Continue**.
   {% endstep %}

{% step %}

### &#x20;Configure your generator settings

1. At **Settings**, fill in these details:
   1. At **Name**, add a descriptive name so it's easier to distinguish this generator from others later.
   2. At **AI connection**, you have two options:
      1. If this is your first generator and you don't have a Gemini or OpenAI connection yet, you can continue with a trial (**Trial > Connect**).&#x20;
      2. If you have a **Gemini** or **OpenAI**  account, click either option > **Connect**.&#x20;
         1. For **Connection type**, select your Gemini/OpenAI connection or create a new one.
         2. Click **Connect with Google Gemini/Connect with OpenAI**.&#x20;
   3. At **Project fields used to generate attributes**, select the **text fields** that should be used to generate the new texts.
   4. At **Field to save the optimized text**, select the project field where you want to save the generated text. We recommend [creating a new field](/get-started/getting-started/fields-in-channable/map-and-add-fields.md) to avoid overwriting your existing title and description data.
   5. At **Output language**, select the language if you want your texts to be translated to. If you leave this at **Do not translate**, the generator will reference the language in the text fields or a prompt when generating.&#x20;

{% hint style="info" %}
**Note:** Choosing **Do not translate** increases the chance of generating inaccurate information. We recommend selecting an output language for more precise control over your generated texts.&#x20;
{% endhint %}

2. Click **Save**.

<figure><img src="/files/R2pgmzzPndCmPd91fyOF" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important:** Trial connections can only be used for one generator per project.&#x20;
{% endhint %}
{% endstep %}

{% step %}

### Select and filter items

1. In the I**tem filtering** step, set up a filter to select which items to generate text for.&#x20;
   1. To generate text for all items, leave the filter as **If** `all` .
   2. To generate text for specific items, set up the condition part of a rule to filter them out. (For example, **If** `title` contains `t-shirt` .)
2. Click **Save**. Once finished filtering, click **Selected items (%)** to see which items your prompt in the following step will apply to.
3. Click **Save & continue**.

{% hint style="success" %}
**Tip:** This filter functions similarly to [Rule conditions.](https://helpcenter.channable.com/hc/en-us/articles/360019983459-How-to-use-conditions-IF-in-rules)
{% endhint %}

{% hint style="warning" %}
**Important:** To save on token costs, filter your items and use specific prompts for each group. Avoid generating texts for thousands of items at once to prevent high costs and the need for revisions.
{% endhint %}

<figure><img src="/files/3WYoohGbqutKko1rxX0q" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Apply a prompt

1. At **Prompt**, write your custom prompt in the text field or adjust the template based on your goals or requirements.&#x20;

{% hint style="info" %}
**Example**

You could change the maximum number of characters based on your channel limitations, or describe the style of the text you want to have.
{% endhint %}

<figure><img src="/files/LLfQocOinecnX12R6qbs" alt=""><figcaption></figcaption></figure>

2. Click <i class="fa-sparkles">:sparkles:</i> **Generate 5 previews**. A preview of the items will appear in the **5 previews** section.

<figure><img src="/files/mmL6JJyGODqLBrjiV0cI" alt=""><figcaption></figcaption></figure>

3. Review the previews and adjust your prompt until you're happy with the results. Once you're satisfied, click <i class="fa-sparkles">:sparkles:</i> **Generate all** to apply the same logic across the items selected in the **Filter items** step.&#x20;

{% hint style="info" %}
**Note:** Generating previews and regenerating values still contributes to token usage.&#x20;
{% endhint %}
{% endstep %}

{% step %}

### Review values (approve & regenerate)

1. To review one generated text at a time select either **Approve** or **Regenerate**. You can also edit each text manually if needed.
2. To regenerate all generated texts at once, click **Regenerate all**. Already approved texts won’t be regenerated.
3. To approve all texts at once, click **Approve all**.
4. To unapprove all texts at once, click **Unapprove all**.

The chosen field for the optimized text now contains the approved values and can be sent to any channel. For example, via **Rules** or **Mapping** steps for Google Merchant Center or Amazon.

{% hint style="success" %}
**Tip:** Enable **Approve new items automatically** to accept the generated values for new items as you import them into Channable.
{% endhint %}

<figure><img src="/files/A3FkIsdu5vIlujmz9s41" alt=""><figcaption></figcaption></figure>

After generating the texts and before using generated texts in your channels, make sure that there are no empty fields. This could cause errors in the product list with generated values but this could also be due to an issue with Gemini/OpenAI.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.channable.com/manage-improve-product-data/optimize-attributes-with-ai/how-to-use-ai-generated-text.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.