Upload image in Variant but width dimension and height dimension parameters are not working

Technical Q&A

Topic summary

Issue: Setting image width/height when creating a Shopify product via API has no effect; returned dimensions reflect the original image instead of requested 1000×1000.

What happened:

  • User created a product (via Postman, REST API) with an images array including src and width: 1000, height: 1000.
  • The source image URL was said to be 571×686.
  • After creation, Shopify’s response shows the stored image as 1289×1547, not 1000×1000.

Technical context:

  • Payload includes standard product and variant fields; image provided via images.src with width/height set in the request body.
  • Response includes product.images with width and height values different from those supplied, suggesting Shopify determines dimensions from the source file.

Current status:

  • No confirmation that width/height can be controlled via the API; fields appear to be ignored and overwritten by actual image dimensions.
  • No resolution or workaround provided yet; discussion remains open.

Notes:

  • Code snippet (API request/response) is central to understanding the issue.
  • A screenshot was referenced for the original image details.
Summarized with AI on February 23. AI used: gpt-5.
1

I upload a photo in shopify

original photo in url is 571*686

beurlux_0-1644419521316.png
beurlux_0-1644419521316.png2160×1336 227 KB

I use postman sent post request to shopify

{"product":{"title":"Burton Custom Freestyle 151","body_html":"\u003cstrong\u003eGood snowboard!\u003c\/strong\u003e","vendor":"Burton","product_type":"Snowboard","variants": [
            {
                "id": null,
                "product_id": null,
                "title": "Default Title",
                "price": "123.30",
                "sku": null,
                "position": null,
                "inventory_policy":"deny",
                "compare_at_price": null,
                "fulfillment_service": "manual",
                "inventory_management": null,
                "option1": "Default Title",
                "option2": null,
                "option3": null,
                "created_at": null,
                "updated_at":null,
                "taxable": null,
                "barcode": null,
                "grams": null,
                "image_id": null,
                "weight": null,
                "weight_unit": null,
                "inventory_item_id": null,
                "inventory_quantity": null,
                "old_inventory_quantity": null,
                "requires_shipping": null,
                "admin_graphql_api_id": null
            }
        ],
"images":[{"src":"https://viettistorage.blob.core.windows.net/product/2655/original/0028e40e-ce45-47a4-b4d3-a260db2bf17f.jpg",
            "width": 1000,
            "height": 1000}]}}

attached photo in test variant and set photo width dimension 1000 and height dimension 1000.

After i sent the post reqeust , I find out the width and height is not 10001000 but 12891547

{
    "product": {
        "id": 7247834251424,
        "title": "Burton Custom Freestyle 151",
        "body_html": "**Good snowboard!**",
        "vendor": "Burton",
        "product_type": "Snowboard",
        "created_at": "2022-02-09T22:55:43+08:00",
        "handle": "burton-custom-freestyle-157",
        "updated_at": "2022-02-09T22:55:44+08:00",
        "published_at": "2022-02-09T22:55:43+08:00",
        "template_suffix": null,
        "status": "active",
        "published_scope": "web",
        "tags": "",
        "admin_graphql_api_id": "gid://shopify/Product/7247834251424",
        "variants": [
            {
                "id": 41719970332832,
                "product_id": 7247834251424,
                "title": "Default Title",
                "price": "123.30",
                "sku": null,
                "position": 1,
                "inventory_policy": "deny",
                "compare_at_price": null,
                "fulfillment_service": "manual",
                "inventory_management": null,
                "option1": "Default Title",
                "option2": null,
                "option3": null,
                "created_at": "2022-02-09T22:55:44+08:00",
                "updated_at": "2022-02-09T22:55:44+08:00",
                "taxable": false,
                "barcode": null,
                "grams": 0,
                "image_id": null,
                "weight": 0.0,
                "weight_unit": "kg",
                "inventory_item_id": 43803455848608,
                "inventory_quantity": 0,
                "old_inventory_quantity": 0,
                "requires_shipping": true,
                "admin_graphql_api_id": "gid://shopify/ProductVariant/41719970332832"
            }
        ],
        "options": [
            {
                "id": 9270284910752,
                "product_id": 7247834251424,
                "name": "Title",
                "position": 1,
                "values": [
                    "Default Title"
                ]
            }
        ],
        "images": [
            {
                "id": 31550419370144,
                "product_id": 7247834251424,
                "position": 1,
                "created_at": "2022-02-09T22:55:43+08:00",
                "updated_at": "2022-02-09T22:55:43+08:00",
                "alt": null,
                "width": 1289,
                "height": 1547,
                "src": "https://cdn.shopify.com/s/files/1/0556/0287/2480/products/0028e40e-ce45-47a4-b4d3-a260db2bf17f_aece5433-7d74-4625-8e97-e0d75cbbc97d.jpg?v=1644418543",
                "variant_ids": [],
                "admin_graphql_api_id": "gid://shopify/ProductImage/31550419370144"
            }
        ],
        "image": {
            "id": 31550419370144,
            "product_id": 7247834251424,
            "position": 1,
            "created_at": "2022-02-09T22:55:43+08:00",
            "updated_at": "2022-02-09T22:55:43+08:00",
            "alt": null,
            "width": 1289,
            "height": 1547,
            "src": "https://cdn.shopify.com/s/files/1/0556/0287/2480/products/0028e40e-ce45-47a4-b4d3-a260db2bf17f_aece5433-7d74-4625-8e97-e0d75cbbc97d.jpg?v=1644418543",
            "variant_ids": [],
            "admin_graphql_api_id": "gid://shopify/ProductImage/31550419370144"
        }
    }
}

the width dimension and height dimension parameters seem to not working

(rest api is the same situation as well)

any ideas?