Congratulations to the Shopify team on the recent release of the 2048 variant limit – it’s a massive improvement and something many of us have been waiting for!
However, I’m a bit puzzled about one thing: whilst we can now create products with up to 2048 variants, the media limit per product remains capped at 250 files (images, videos, 3D models combined).
For products with visual variants (e.g., different colours, patterns, or finishes), this creates quite a bottleneck. A product with 2048 variants could theoretically need many more than 250 images to properly showcase each option – especially if you’re following best practices of showing multiple angles or lifestyle shots per variant.
What’s more, we’re already running into this 250-image ceiling with several of our merchants. They have products with dozens of variants and legitimate needs for multiple images per variant, but they’re hitting the limit and can’t properly showcase their full range.
I understand that most merchants won’t need all 2048 variants, and perhaps Shopify’s thinking is that 250 is sufficient for the majority of use cases. But it does seem like there’s a bit of a mismatch between these two limits. If a product has, say, 500 variants with distinct visual differences, you’d only be able to assign images to a fraction of them.
Has anyone else run into this limitation? Are there any plans to increase the media limit to better align with the new variant capabilities, or is there a technical reason why 250 remains the ceiling?
Would love to hear thoughts from the community and perhaps get some insight from the Shopify team if possible.
I see those docs explain how to support high-variant products on the frontend despite the 250 product.variants cap in Liquid. That makes sense.
But the issue we’re facing is different: we need to upload and manage media for 500+ variants via the Admin API. The frontend can handle displaying them intelligently (as your docs show), but there’s still a hard 250 media file limit per product at the API level.
Those are two separate problems.
Has there been any update on the 250-media-file limit per product in light of the new 2048-variant support? We are getting an increasing number of merchant requests who are hitting that media ceiling when each variant needs its own image.
If anyone from the Shopify team or community has insight or a roadmap for lifting or extending the media cap, it would be very useful.
I’d also be curious to know when the 250 product media limit will be increased?
Right now, it’s not actually allowing us to use the newly increased variant limit as we have 51*6 option values and therefore surpassing the limit by 56 media files.
Any insight on when this limit will be increased would be helpful.
I can confirm that a 250 product media limit increase was not included as a part of the 2048 variant limit increase that was released with Winter Editions 26.
We can’t discuss any up coming features or roadmaps that haven’t been announced publicly yet, so I can’t confirm or deny if an increase for this would be coming to the platform, or when.
I can however submit some feedback on your behalf internally, that you would like to see this increase happen as you are hitting the limit more often now after the 2048 variant increase. While we can’t guarantee when or if this will occur, I can assure you that our developers and product managers do take all of our partner and merchant feedback with great value, and the more feedback we get for topics like this, the more likely and quicker it would be added.
I do also have a potential workaround that you can use in the meantime, using Product Metafields, storing a file reference that you can use on the theme, to get around the product media limit.
Upload the image as a file to the store directly, using the fileCreate mutation
Additionally, @danilichti, we do ask that you please refrain from pinging staff members, forum moderators, or any users that have not been involved in a thread already, as it is actually mentioned in our Community Guidelines.
Thanks for the clarification and for submitting the feedback internally – I appreciate that.
I do want to emphasize that for our merchants, this media limit is becoming a critical bottleneck. The 2048 variant increase was very well received, but without a corresponding media limit increase, it unfortunately makes the feature almost obsolete for many product types that rely heavily on variant images. It’s a bit like expanding the garage but not the driveway.
Regarding the workaround suggestion: while I appreciate the technical guidance, it’s not a viable option for us. Our app’s core value proposition is built around using native Shopify features and standards – no workarounds, no custom theme code. We specifically don’t touch storefront or theme implementations to maintain compatibility and simplicity for merchants.
I hope the team will consider prioritizing this alongside future variant-related improvements, as these two limits really need to scale together to be effective.
thanks as well for the clarification and insights and sorry for the pinging, I wasn’t aware this violates the community guidelines.
Concerning your workaround suggestion:
We have thought about using a variant metafield to store the variant image.
The issue with this setup is, that it only works as long as a customer hasn’t added the variant to the cart/made a purchase, as it obviously would create a mismatch between the final variant image a customer sees on the product page and the variant image they see during checkout or on the order confirmation page.
This would very likely cause high Cart and Checkout Abandanonments.
Perhaps you have a workaround suggestion for this mismatch as well?
I completely understand your concern with added complexity for merchants using your apps, and I can confirm that I have submitted feedback on your behalf internally already.
If you were open to exploring further options, I may recommend looking into Theme Extensions and App Blocks, that way you can create theme customizations that are extremely simple for merchants to implement directly from the Theme Editor, just adding a simple theme block in the Theme Editor, that injects any needed code from your app, with no need for the merchant to actually touch their theme code themselves.
I do agree this is not ideal, especially with the image displayed for line items at checkout. While I don’t have a direct workaround to replace the line item image, I do have something that might help if you get a bit creative with it.
Using Checkout UI Extensions, you can target the line item details section directly below the individual line items in the Order Summary in the checkout.
So while you can’t change the actual line item image directly here, you can add additional information or images saved in metafields in the details directly below it.
thank you for the proposal, which would be an interesting workaround.
However, without a Shopify Plus plan, this won’t be a solution and leaves us with no option to start selling a new product until the limitation of 250 variant images has been lifted.
You are right this would be limited to Plus stores, as Checkout UI Extensions are limited to stores on the Plus plan only at this time.
Again I know it’s not ideal, but if you can potentially inform customers on the cart that the image displayed might not represent the variant they selected, that might help prevent abandoned checkouts due to customer confusion.
You could use a generick product image for any variants that need images over the 250 limit, and add a Line Item Property to the cart before the customer gets to checkout, to display a message directly below the individual line items.
You can add line item properties to carts for all store plans, both with Storefront API and on Online Stores via AJAX API or Cart Form Input.
