PromoSync only uses the images a supplier sends through PromoStandards, and it leaves some out on purpose: small files, swatches, broken links and any image types you've excluded. When images are missing, check what the supplier sends first, then run Add Missing Images, which adds what's missing and never removes anything.
Where PromoSync gets images
Suppliers publish their images through a PromoStandards service called Media Content: a list of image files for each product, color and part, each labeled with a type such as Primary, Blank (the item with no logo) or Decorated (the item with a sample logo).
- The first image on each product follows Image Order in Shop Settings, under Product Display Settings: Primary (the default) or Blank.
- Each variant gets the image for its color. When a product has several colors but the supplier only sends product-wide images, PromoSync leaves the variants without an image on purpose, so a shopper never sees a picture of the wrong color.
- Bulk Import by IDs has an Images to import choice. First image only brings in one image per product.
What PromoSync leaves out
- Images smaller than Minimum Image Resolution, which starts at 800. Images the supplier marks as high definition are kept, and so are images that don't report a size at all.
- Swatches (small color chips) and 3D model files.
- Links that don't open when PromoSync checks them.
- Types you picked in Excluded Media Class Types, such as 1002 - Decorated.
- TIFF files when Import TIFF Images is off.
When the supplier sends no images for a product, there is nothing for PromoSync to bring in, and only the supplier can fix that.
Add the missing images
- Open the product in Data Explorer and click MED to see the images the supplier sends.
- If MED is empty, stop here: the supplier isn't sending images for this product.
- If the images are there but small, lower Minimum Image Resolution in Shop Settings and click Save.
- In Shopify's Products list, select the products with missing images.
- Click ..., choose Bulk Product Sync, pick Add Missing Images and click Submit.
- Read the Add Missing Images Results email that goes to your notification contacts.
Add Missing Images adds the supplier images a product doesn't have yet and gives an image to any variant that has none. It never deletes or replaces an image, including ones you added yourself. You can also run it for a whole supplier or collection from Targeted Sync on the PromoSync dashboard.
The email gives a reason for every product it skipped:
| The email says | What to do |
|---|---|
| Supplier returned no media | Often a short hiccup on the supplier's side. Run it again later |
| No importable images | Every image was left out by your settings. Loosen Minimum Image Resolution, Excluded Media Class Types or Import TIFF Images, then run it again |
| All supplier images already present | Nothing is missing. The product has every image the supplier sends |
| Not linked to PromoSync | Run Onboard to PromoSync on the product first |
When the images are wrong
- Logo samples or decorated photos are showing. Add 1002 - Decorated to Excluded Media Class Types, or set Image Order to Blank. These settings apply to new imports and to Add Missing Images, not to images already on a product. Delete the unwanted images in Shopify, then run Add Missing Images to fill the gaps.
- Images come in with a blank background. Some suppliers' TIFF files turn blank when Shopify converts them. Turn off Import TIFF Images and run Add Missing Images again after deleting the blank ones.
- Only one supplier needs different rules. Open Supplier Overrides > Add Supplier Override. Image Order, Minimum Image Resolution and Excluded Media Class Types can be set for that supplier alone.
Per-variant image galleries are part of PromoSync Merchandising, which is included in the Business and Enterprise plans and is an add-on on Premium (Plans and billing).
Class types come from the supplier's Media Content classTypeArray (1001 Blank,
1002 Decorated, 1004 Swatch, 1006 Primary, 2001 High Definition). An image is dropped when it reports a
height below Minimum Image Resolution, unless it's high-res: height of 1000 or more, dpi above
300, or class type 2001. Add Missing Images decides what's already there by comparing image alt text,
so an image you uploaded with a different alt text can get a near-duplicate next to it.
When to contact us
Email support@psrestful.com if MED in Data Explorer shows images but Add Missing Images keeps skipping the product, or if a variant shows another color's picture. Include the supplier, the product ID and the results email.