Images are not imported
Troubleshooting when product images are not imported correctly via CSV in Shoporama.
Are you having trouble importing images correctly via CSV import or using the "Import Images from URL" feature on a product page? Here, we'll go over the most common causes and how to resolve them.
Image URL Requirements
For Shoporama’s server to retrieve your images, the following requirements must be met:
1. Use absolute URLs
The image URL must be a complete, absolute URL with a protocol:
| Type | Example | Status |
|---|---|---|
| Absolute URL | https://www.example.com/img/product.jpg | Correct |
| Relative URL | /img/product.jpg | Incorrect |
2. No password protection
Images must not be behind a login or password protection. Shoporama’s server cannot log in, so the image cannot be retrieved.
3. The URL must point directly to the image
Try opening the URL in a browser. If a website appears instead of just the image, the URL is incorrect. The URL must go directly to the image file.
4. The server must accept server requests
Some web servers block requests from other servers (bots). The image displays fine in your browser, but Shoporama’s server receives an error (typically 406 Not Acceptable). The notification will then state, “The server rejected our request.” Upload the images to a different server, or ask the server administrator to allow automated downloads.
5. The URL must be a public address
Shoporama only retrieves images from public http and https addresses on the internet. If the URL points to an internal network, such as localhost, 127.0.0.1, or 192.168.1.10, it will be rejected. This also applies when a domain name or a redirect ends with such an address. This is a security measure and cannot be disabled.
See why an image wasn’t imported
If an image cannot be retrieved, you’ll receive a notification with the URL and the reason. Click the bell icon at the top of the admin panel and select “View All.” On the “Notifications” page, you can view the full message and select “Import” under “From” to see only errors related to image imports.
If the message says, “We only retrieve images from public http and https addresses. Check the URL,” the URL is not a complete, public address. This happens when https:// is missing at the beginning (point 1), when the URL contains a username and password (point 2), or when it points to an internal network (point 5).
Shoporama won’t attempt to retrieve the image again on its own. If it’s just one image, open Product Images for the product, click Import Images from URL, enter the corrected URL, and save. If you edit your CSV file instead, enter all of the product’s images in the cell, as the image column will replace the product’s images.
Tip
The images are fetched in the background after you’ve saved the product or run the import. They’re usually in place within a few minutes. If there are many images in the queue—for example, from a large import—it may take longer. As long as a product is waiting for images, it will say, for example, “3 in import queue” under Product Images for that product. Once the number disappears, Shoporama has attempted to retrieve all the images. If an image is still missing, check your notifications as described above.
Do you need help with image import? Contact us at support@shoporama.dk.
Related articles
Images on landing pages
How to upload images to a Shoporama landing page and display them correctly in your theme with getImages() and getSrc().
Optimizing images for mobile
Guide to using responsive images with srcset in your Shoporama theme to provide optimized images for mobile users.
Associate images to a variant
Guide to associate product images to specific variants so that the correct image is displayed when selecting a variant.
Related features
Import features - move your shop or update thousands of products
Import via CSV or migrate from Shopify, DanDomain and Magento 2. Products, categories, prices, stock and extra fields.
Import your products from a CSV file or another platform
Import your products from a spreadsheet, Shopify, DanDomain, or Magento. Here's how to prepare the file, include images and inventory, and avoid...