ChannelEngine: manage products via the web interface
About this article
This article explains how to create, edit, clone, archive, and delete products via the ChannelEngine web interface.
Table of contents
Introduction
There are three ways to create and manage your products on ChannelEngine:
- Via a product feed
- Via the Merchant API
- Manually (this article)
Unlike feeds and the API, manual product management lets you edit products directly and instantly in the ChannelEngine web interface as you browse your catalog.
Manage your products manually if you want to:
- Fix an urgent issue, e.g.: a wrong price
- Create/update a small part of your catalog
- Clone a product
- Enrich your product with more standard fields
- Avoid dependency on the API connection or feed schedules
To manage your products manually, go to Products, Products.
Limitations
- You can manually create only standalone products. Grandparent-parent-child relationships are established via product feeds or the Merchant API.
- Bundles cannot be edited via the product details page. To edit product bundles, go to Products, Product bundles. See ChannelEngine: product bundles for details.
Create a product
To create a product via the web interface:
- In Products, Products, click Create product on the left.
- Fill out required, recommended, and optional fields. See fields for details.
- Click Create product to confirm.
- You are redirected to the new product's product details page.
If the merchant product number you entered already exists in your tenant, or if a required field is missing, ChannelEngine highlights the relevant fields with an error.
You can manually create only standalone products. Grandparent-parent-child relationships are established via product feeds or the Merchant API.
Fields
Required
The following fields are needed to create a viable product on ChannelEngine. In theory, only a Merchant product number is enough, but the more fields you include when setting up your products on ChannelEngine, the more time you save when listing your products on your channels later.
Required product fields
| Attribute | Description | Example |
| Merchant product number | Your unique product number. Maximum of 30 characters. No special characters. For extra guidelines, see ChannelEngine: merchant product numbers/SKUs | 192354-TSHRT |
| GTIN | The product's universal identifier, e.g.: EAN, ISBN, or UPC. Valid lengths are 8, 12, 13, or 14 digits. | 8710400311140 |
| Name | Product name | Black t-shirt with crew neck |
| Description | Product description | A simple black t-shirt from Sustainable T-shirts Inc. |
| Price | Product price (incl. VAT/sales tax) | 49.95 |
| Stock | Product stock | 25 |
| Category trail | The product's full category path (with each category separated by >) | Men's > t-shirts > Crew neck |
| Image URL | Deep link to the product's image. For guidelines, see Image guidelines. | http://www.theshirtshop.com/images/products/192354.jpg |
Recommended
While not mandatory, it is highly recommended to provide the following fields.
Recommended product fields
| Attribute | Description | Example |
| Catalog price | Manufacturer’s suggested retail price (incl. VAT/sales tax) | 59.95 |
| Purchase price | Product purchase price (excl. VAT/sales tax) | 35.00 |
| Min. price | The minimum price at which you sell the product and are still profitable (incl. VAT/sales tax) | 40.25 |
| Max. price | The maximum price at which you can sell the product and still be competitive (incl. VAT/sales tax) | 52.25 |
| VAT | VAT/sales tax percentage. Must be a decimal value, without the percentage symbol (%) | 21.00 |
| Vendor product number | Manufacturer/Supplier product number | FTI-BLK-XL |
| Brand | Product brand name | Fancy T-Shirts Inc. |
| Color | Product color | black |
| Size | Product size | XL |
Make sure your price attributes use a period ( . ) as the decimal separator. E.g.: 50.99. Do not use a comma ( , ) as a thousand separator.
Optional
The following attributes are not required, although they may be conditionally required on certain channels.
Optional product fields
| Attribute | Description | Example |
| Margin % | The margin between the price and purchase price in percentage | 30 |
| Stock locations | The number of stock units assigned to each warehouse. Only needed if you use multiple stock locations. | E.g.: Toronto warehouse -> 5 |
| Shipping time (days) | Delivery time indication | 2 |
| Segment | The business segment a product belongs to. Use it to group products into a broader, high-level category. | T-shirts |
| Details | The product's details | A simple t-shirt. Color: black. Brand: Sustainable T-shirts Inc |
| URL | Deep link to the product's details page | http://www.theshirtshop.com/ products/192354-black-t-shirt-with-crew-neck.html |
| Extra image 1-9 | Deep link to the product's additional images | http://www.theshirtshop.com/ images/products/192354-1.jpg |
Image guidelines
ChannelEngine does not host or store product images. You provide a URL per image, and the marketplaces fetch the image from that URL.
Follow these guidelines to make sure your product images pass validation.
- URL: publicly accessible via HTTP or HTTPS, without authentication. Host the images on your own server or on a public hosting service, e.g.: Flickr, Google Photos, Imgur, Dropbox, or Google Drive.
- Images from cdn.channelengine.net or img.channelengine.net are not supported. ChannelEngine replaces them with a placeholder.
- Formats: JPEG or PNG. Extensions must be lowercase, e.g.: image.png, not image.PNG.
- Resolution:
- Minimum: 500×500 px
- Maximum: 5,000×5,000 px
Each marketplace has its own image requirements. If an image does not meet them, the marketplace rejects it during publishing. Check the related marketplace guide.
Main image (Image URL)
- White background (no shadows, props, or additional items; the product should fill most of the frame).
Additional images (Extra image 1-9)
- Can show different angles, backgrounds, contexts, or related items to showcase the product better.
Edit a product
To edit a product via the web interface:
- In Products, Products, locate the product you wish to edit and open its product details page.
-
In the top right corner of the Content widget, click the three-dot menu.
The three-dot menu in the Content widget of the product details page - Click Edit product. All current field values are prefilled.
- Edit fields as you see fit. See fields for details. You cannot change the merchant product number.
- Click Update to confirm.
If an active product feed, merchant plugin, or API import includes the same product, it may overwrite manual changes unless the feed mapping excludes those fields or the product is frozen.
Clone a product
Use cloning to create products with minor differences so you do not have to reenter all fields manually.
To clone a product via the web interface:
- In Products, Products, locate the product you wish to clone and open its product details page.
- In the top right corner of the Content widget, click the three-dot menu.
- Click Clone product.
-
Most product fields are prefilled with the values of the original product, except for the product's merchant product number and stock.
Product images might copy incorrectly. Supply image URLs for the clone product.
- Enter a new merchant product number and change any other fields that differ. See fields for details.
- Click Create product to confirm.
Archive a product
Use archival to remove a product from your product selection and delete the listing from the marketplace. You can reuse the product's merchant product number for a different product later, for example to convert a standalone product to a bundle.
Before you archive a product, remove it from your product feed or API. Otherwise, the next sync recreates the product.
To archive a product via the web interface:
- In Products, Products, locate the product you wish to archive and open its product details page.
- In the top right corner of the Content widget, click the three-dot menu.
- Click Archive product.
- The confirmation banner appears to prevent accidental archival.
- Click Archive product to confirm.
Delete a product
Like archiving, use deletion to remove a product from your product selection and delete the listing from the marketplace. However, you cannot reuse the product's merchant product number later, as it stays reserved for the deleted product.
Before you delete a product, remove it from your product feed or API. Otherwise, the next sync recreates the product.
To delete a product via the web interface:
- In Products, Products, locate the product you wish to delete and open its product details page.
- In the top right corner of the Content widget, click the three-dot menu.
- Click Delete product.
- The confirmation banner appears to prevent accidental deletion.
- Click Delete product to confirm.
ChannelEngine uses soft deletes for products, so if you remove a product by mistake, contact Support to reactivate it for you.
Common issues
| Issue | Cause | Resolution |
| The product cannot be created. | The merchant product number is missing. | Supply the unique merchant product number for your product. |
| The product cannot be created. | The merchant product number already exists in your tenant. | Enter a unique merchant product number, or edit the existing product instead. |
| New images do not appear on the product details page. | The old cached image appears. | Go to the product details page and click Clear image cache to refresh. |
| Images are rejected although their dimensions are correct. | Your hosting provider, e.g.: Azure Blob Storage, resizes the images automatically. | Open the image URL in a browser, inspect the image (F12), and check the rendered width and height. Adjust the settings of your hosting provider. |
| Manual changes are overwritten. | An active product feed or API import includes the same merchant product number. | Exclude the fields from the feed mapping (product feed) or remove the product from the payload (Merchant API). |
| An archived product reappears. | The product is still in your product feed or API. | Remove the product from the feed or API before you archive it. |
| An image is rejected. | The URL requires authentication, the format is not JPEG or PNG, the extension is uppercase, or the resolution is below 500×500 px or above 5,000×5,000 px. | Check the image against the image guidelines. |
| A marketplace rejects an image that ChannelEngine accepted. | The marketplace has stricter image guidelines. | Check the related marketplace guide. |
| A price is saved incorrectly. | A comma is used as the decimal or thousand separator. | Use a period ( . ) as the decimal separator. Do not use a thousand separator. |
| Parent-child variants cannot be created manually. | Manual creation supports standalone products only. | Use a product feed or the Merchant API. |
FAQs
Does ChannelEngine validate field values?
No. ChannelEngine only checks that the merchant product number is present and unique. Marketplaces, however, validate your content on export and may reject it. Check the related marketplace guide for requirements.
Comments
0 comments
Article is closed for comments.