> 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/creatives-create-and-edit-images/create-and-edit-your-images.md).

# Create and edit your images

The image editor allows you to create and edit your images. Before you start, there's a little bit of [preparation](#map-image-product-fields-to-the-image-type) that you need to do.

### Before you start

#### Map image product fields to the 'image' type

Make sure that all project fields you are going to use for images are correctly mapped to Type: 'Image' in the import mapping. This applies to imported project fields and project fields you have created manually.

1. Go to **Setup** > **Import** > **Mapping**.
2. Click **Edit** next to the project field you want to use and make sure the project field **type** is set to **Image**.

{% hint style="warning" %}
Important: Make sure the images you want to use from your import are PNG, WebP, JPG, or JPEG files (other file types won’t work). The Image Editor itself will only create PNG files.
{% endhint %}

{% hint style="info" %}
If you change image URLs with rules, use [import rules](/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable/import-rules-in-channable.md). Image URLs changed later in channel rules may not be tracked.
{% endhint %}

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

<figure><img src="/files/796ca434ed26dd2782141113cd6ba13894a35857" alt=""><figcaption></figcaption></figure>

#### Set up the feed you want to create new images for

The Image Editor can be used with any feed in the Feed section. First, create (or copy) a feed for the channel you want to create optimized images for.

{% hint style="info" %}
Tip: If you want to check image generation before sending to an advertising channel, start with a feed that isn’t used on a channel yet.
{% endhint %}

{% hint style="info" %}
Images may need time to download after an import. You cannot generate edited images until downloading finishes.
{% endhint %}

## Set up the image editor

{% stepper %}
{% step %}

### Set up a first image rule

Example: Meta feed (Facebook/Instagram)

1. In the feed, go to **Rules** > **Image rules** to create an image rule.
2. In **Create an image rule**, enter a **Rule name**.

{% hint style="warning" %}
Important: You can apply a maximum of five templates to the same item.
{% endhint %}

{% hint style="info" %}
Tip: If you want to check image generation before sending to an advertising channel, start with a feed that isn’t used on a channel yet.
{% endhint %}
{% endstep %}

{% step %}

### Create a template

1. Open the **Select a template** dropdown and choose **+ New template**.
2. Give the template a name and click **Create** to open the Image Editor.

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

First [choose the correct size for your canvas](/manage-improve-product-data/creatives-create-and-edit-images/create-an-image-template/adjust-the-size-and-background-of-an-image.md#adjust-canvas-size). Then build your template by adding [static](/manage-improve-product-data/creatives-create-and-edit-images/create-an-image-template/upload-static-images.md), [dynamic](/manage-improve-product-data/creatives-create-and-edit-images/create-an-image-template/add-dynamic-image.md), or [brand](/manage-improve-product-data/creatives-create-and-edit-images/create-an-image-template/add-brand-image.md) image objects, [text](/manage-improve-product-data/creatives-create-and-edit-images/create-an-image-template/add-text.md), and shape objects from the top-left corner.
{% endstep %}

{% step %}

### Add an image object

* Click **Image** then **Add dynamic image** to create an image object.
* To select an image, click Design in the right menu.
* Use the dropdown next to Image field and choose the image field for this object.

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

Learn more about [image object settings](/manage-improve-product-data/creatives-create-and-edit-images/the-image-editor/image-editor-basics.md#layer-types).

{% hint style="info" %}
Important: Maximum of 10 images per template.
{% endhint %}

{% hint style="info" %}
Note: The above adds a dynamic image. Learn about [adding a static image](/manage-improve-product-data/creatives-create-and-edit-images/create-an-image-template/upload-static-images.md) that is the same for all items.
{% endhint %}
{% endstep %}

{% step %}

### Add a text object

* Click **Text** to add a text object.
* In Design, edit the value field to add static text, dynamic text (connect a project field), or a combination of static + dynamic text.

<figure><img src="/files/98dff15225dfe3ec9d7b33b74281a9efc43ee236" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Learn about [adding a custom font](/manage-improve-product-data/creatives-create-and-edit-images/the-image-editor/brand-kit/upload-a-custom-font.md).
{% endhint %}

{% hint style="info" %}
Learn more about [text settings](/manage-improve-product-data/creatives-create-and-edit-images/the-image-editor/image-editor-basics.md#layer-types).
{% endhint %}
{% endstep %}

{% step %}

### Add a shape object and change layer order

* Click Shape to add a static shape.
* Use the Design tab to change the shape’s appearance.
* To change layer order, such as moving a shape behind text, open **Layers** and drag layers using the three-stripes icon. When finished, click **Save**.

<figure><img src="/files/14faf31eb07b01cb2c7f694ba08bc735d2fc52db" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Learn more about [shape object settings](/manage-improve-product-data/creatives-create-and-edit-images/create-an-image-template/add-shapes.md).
{% endhint %}
{% endstep %}

{% step %}

### Apply the template to products

1. Click Back (top left) to return to the image rule.
2. In the THEN part of the rule click Select a template and pick the template you created.

If you only want to apply the template to certain items, set the appropriate conditions in the IF part of the rule.

{% hint style="warning" %}
Important: By default, an item is edited by the first image rule that selects it. Later matching rules skip that item.

To apply multiple templates to one item, use the [AND option](/manage-improve-product-data/creatives-create-and-edit-images/image-rules/apply-multiple-templates-per-channel-or-per-item.md).
{% endhint %}
{% endstep %}

{% step %}

### View results

1. Click **Preview results** on the right side of the image rule.
2. Check how the template appears on selected images.

The generated image URL does not appear in rule results. It is created during the feed export.

Check the lower-right corner of **Image rules** to view image download progress. Select **See full progress** to view details in import setup.

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

{% step %}

### Store the Image URL and set safety settings

1. In your image rule, select an image field to store the new image URL.
2. Click Save rule and continue to the Finalize step in your feed.
3. Connect the correct internal image field to the channel field name.
4. Click Save & run to generate the feed.

Generated image URLs start with: *<https://channableusercontent.com/>*

If there are errors while generating images, the feed will fail to run. See errors in the feed’s Status tab and via[ email notification ](/account-billing/manage-your-account-and-settings/manage-your-notification-settings.md)(if enabled).

Set [Safety settings](broken://spaces/UAGSVlvcNsqEqVUgr0tD/pages/a582eb7f77d6d196d45e334c4b7a8d8430bd0a01) to control what happens when image generation fails.

Go to **Settings** → **Advanced settings** → **Image generation safety**.

You can fail the feed, remove affected items, or use a backup image field.

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

If you encounter errors in the Image Editor, see this [troubleshooting article.](/manage-improve-product-data/creatives-create-and-edit-images/troubleshooting.md)

If issues persist, [contact us](https://www.channable.com/contact) for assistance.
{% endstep %}

{% step %}

### Open existing templates to edit

* To edit an existing template, go to Select a template and choose one you created earlier.
* Click Image editor to open the Image Editor with your selected template.

<figure><img src="/files/a628b12c2e664ed30a27d0ff6969196277ff7f11" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# 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 dynamically by asking a question.

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

```
GET https://helpcenter.channable.com/manage-improve-product-data/creatives-create-and-edit-images/create-and-edit-your-images.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
