Skip to main content
​
url
string<uri>
required

Public HTTP or HTTPS image URL.

Maximum string length: 8192
​
external_media_id
string

Stable source media ID that variants may reference.

Maximum string length: 255
​
alt_text
string
​
role
string

Prefer full-product front, back, or side views on a model or mannequin; featured, primary, and gallery are also accepted.

Maximum string length: 255
​
position
integer
default:0
​
width
integer
Required range: x >= 0
​
height
integer
Required range: x >= 0