👕 Product Images
This guide explains how to manage product images through the Seven Senders API.
What are Product Images?
Product images are stored in Seven Senders and associated with each product by its SKU. Each product can have one image that is accessible through a publicly available URL.
How Product Images Work
When you upload a product image:
- The image is stored in Seven Senders infrastructure
- A publicly accessible URL is automatically generated
- The URL is associated with the product's SKU
- The
image_urlfield becomes available in Product API responses
Managing Product Images
Adding or Updating Images
You can upload or replace a product image at any time. Images must be:
- Encoded as base64 strings
- Associated with an existing product SKU
- Provided with a filename
When you upload a new image, it automatically replaces any existing image for that product.
Removing Images
Product images can be deleted when no longer needed. After deletion, the image_url field will be null in product responses.
Retrieving Image URLs
Once uploaded, the image URL is included in all product data responses. This URL can be used to display the image in your systems, tracking pages, or customer communications.
Image Requirements
Supported Formats
JPEG or PNG formats are supported.
Size Recommendations
- Maximum file size: 10 MB (recommended)
- Recommended dimensions: 800x800 pixels or higher
- Aspect ratio: Square (1:1) for best display across platforms
Encoding
All images must be base64-encoded before upload. Most programming languages and platforms provide built-in base64 encoding capabilities.
Common Use Cases
- Order Items - Product images are linked to order items for complete order visibility
Updated 1 day ago