Images
Extended information on product and variant images.
Overview
Include the URL for your product images with the image attribute. This image appears to potential buyers. Images are displayed to users in order equal to their position in the array. e.g. the first image URL in the images array will be used as the first image of the product in search results and the product page.
When to use
Required for each product and variant
Format
Follow these formatting guidelines to make sure that Axiom understands the data that you're submitting.
| Type | URL (including http or https), ASCII characters only, and RFC 3986 compliant |
|---|---|
| Limits | 1-2,000 characters |
| Supported file formats | JPEG (.jpg/.jpeg), WebP (.webp), PNG (.png), GIF (.gif), BMP (.bmp), and TIFF (.tif/.tiff). The image's file extension should correspond to its format. |
| Repeated field | Yes |
| Variant Inherits | Yes |
Guidelines
Follow these guidelines to make sure that your image URL is formatted so that we can understand it.
Minimum requirements
These are the requirements that you'll need to meet to show your product. If you don't follow these requirements, we could reject your product.
- Use a URL that points to an image in a supported file format.
- Start with
httporhttpsand comply with RFC 3986. For example:http://www.example.com/image1.jpg. - Replace any symbols or spaces with URL encoded entities. For example, if your URL contains an ampersand (
&), then replace it with%26. If your URL contains a comma (,), then replace it with%2C. - Make sure that your URL can be crawled by Axiom. Make sure authentication is not required to view the image.
Best practices
These best practices can help you go beyond the basic requirements to optimise your product data for performance.
- Use a stable URL. The URL that you include shouldn't change unless your image moves or is replaced. For example, don't use URLs with timestamps or parts that could change every time you submit your product data.