Troubleshooting

Fix common Image Editor errors, including field, template, format, and image generation issues.

Expand the error message you see, then follow the matching resolution below.

Where do I find, and how do I resolve errors?

After activating your template in Image Rules, open Preview & export.

Select Edited image errors to view current errors.

Select an error to see its cause and affected items.

Field does not exist

This issue occurs when a template references a non-existent Project Field. This can happen when a text object in Project A uses sale_percentage. If Project B has no sale_percentage field, the error "This field does not exist!" appears when you apply the template.

Solution: Make sure that all referenced project fields exist in the projects in which the template is used.

Field is not of type Image

This message appears when a field does not have the Image type. This applies to image objects in the template and the field where the edited image is stored.

One way to run into this issue is if you are using a field like image_link and you import this field as a type Text as the field to "Store URL in" of an Image Rule.

Another reason for this error would be to not have a field set in the "Store URL in" part of the rule or to reference a non-Image field here.

Solution: Make sure that all fields used within the feature are of Type: Image. This can be done in the import mapping.

Image format is not supported

This error will be visible when anything other than PNG, WebP, JPG, or JPEG is used as an image format in the import. We can only process images of these formats as input. Note that the resulting images from the Image Editor will always be in PNG format.

Template does not exist

This happens when a template that has been deleted is (still) being referenced in a project. Since Templates can be accessed and deleted from anywhere in a company, there may be references to the deleted templates after they have been deleted. Rather than deleting every image rule in which the deleted template is referenced, a warning will be displayed where these templates are used.

Solution: In each affected image rule, select a replacement template or remove the deleted template.

Image not tracked

What does this error mean?

This error means our system cannot locate the image URL you are trying to use.

Our system couldn't extract the image link from your import data. Even though your field may be set to "Image," the export failed for this specific item because the URL couldn't be processed.

How to solve this error

1. Check your field type Ensure the project field has the Image type, not Text. You can still use an Image-type field as text in rules. Check this in Setup → [your import] → Mapping.

   
2. Only make URL changes in Setup > Import rules If you are using rules to change, clean up, or change your image URLs, make sure these rules are set up as import rules. This ensures our downloader reads the final URL and tracks it successfully. Changing URLs in channel rules means the downloader has already run, and it will miss the updated link.
3. Verify your subscription/plan Image downloading is automatically included if you have the Creatives plan.

• If you are not on the Creatives Plan: You can still test the Image Editor, but images will only download if you are actively using an image template in an image rule.

Image not downloaded

This error will pop up when an image from an item in the stream that is being edited has not yet been downloaded. Because of that, we cannot generate the edited image.

After an image link has been extracted from the import, this link will enter a queue to have its image downloaded. This means that there is a delay between the import finishing and the images being available to generate edited images.

Solution: Wait until the image is downloaded. If the image never gets downloaded, check from the source (import) if the image is available for downloading.

Specific item is failing, but not sure which one

An export with Image Rules is failing because of a specific item. The error itself does not give a lot more detail. However, the most likely reason for this error is that the Unique ID for an item is not set.

Make sure that the correct (and the same) Unique ID is set for the project and the export. This should be a unique identifier per item that should be exported in the feed.

In the project settings, you can find the Unique ID here:

Note: The Unique ID in every export feed can have a different name. Example names for this unique number are id, g:id, sku_id, etc.

Image cannot be generated

Manage image-generation failures through Safety settings.

Go to Settings → Advanced settings → Image generation safety.

Choose one of these options:

• Fail the feed and send a notification — Stops the feed. This is the default.
• Remove items where image generation fails — Excludes only affected items.
• Select project field containing backup image link — Uses a fallback image from a project field.

Why are there no project fields shown? I want to select an image from my project fields.

No available project field has the Image type.

Create a project field or change an existing field to Image in Setup → [your import] → Mapping.

Why do I get the message that there are no items?

Only one Image Rule can be applied to an item. The first Image Rule that includes an item will be the one applied to that item, and following rules selecting the item will skip that specific item.

Therefore, the order of the rules is important. We advise having the most narrow filters in the first rule, and then widen the filter for subsequent rules.

Why can’t I select a nested field as my result field?

This is due to technical reasons. We only support storing the edited images in non-nested fields, and therefore do not display nested fields in the dropdown for storing the URL.