Troubleshooting
This article provides solutions for the most common errors and issues you may encounter while using the Channable Image Editor.
By following these troubleshooting steps, you can quickly resolve problems related to image generation, template application, and rule configuration.
Where do I find, and how do I resolve errors?
After activating your template in the Image Rules, you can find an overview of all current errors by navigating to the Preview step and selecting the Image errors tab. Open an error by clicking on the title, and you'll find the specific reason for the error and which items the error relates to. Follow the given instructions to solve the error.
Field does not exist
This issue occurs when a Template references a non-existent Project Field. This can happen, for example, when a template is created in Project A using sale_percentage as part of a dynamic text object. Later, when you want to apply this Template to items in Project B, where there is no field sale_percentage in the import, the error "This field does not exist!" will appear.
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 will pop up when you are trying to use a field that does not have the Type of the field set to Image. This applies to both image objects in the Template and the field where the edited image will be 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: Remove references to deleted Templates in the affected Image Rules.
Image Not Tracked
This error means that we do not have the image link being referenced in our tracking, and therefore cannot use it as an image.
The process that extracts image links from the Import couldn’t extract the image link that is being referenced. So, even though the Project Field being referenced is of type Image, the creation of edited images in an export may fail for a specific item for which the image link extraction didn’t properly work out.
Solution: Try rerunning the importer and wait (preferably) an hour after it’s done. If this doesn’t work, contact our support team for further investigation.
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
When an image cannot be generated (for example because of errors like "image not tracked", "unsupported extension", or "image not downloaded" for specific items within an image rule), you can choose how Channable should handle it via the Safety settings in the Settings tab of your channel.
Options:
Fail the feed and send a notification (default setting)
Remove the items from the feed if the image generation fails
Use a backup image link by selecting a project field
Why are there no project fields shown? I want to select an Image from my project fields.
This means that there are no fields in your import, or in your setup project fields, that have the field type 'Image'.
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.
Last updated
Was this helpful?