Help! Upload images using REST Admin API

Topic summary

Uploading images to a Shopify store via the REST Admin API and migrating theme assets between stores.

  • You can upload a theme asset by sending a PUT to the Assets endpoint and setting the src field to an external URL.
  • The URL must be publicly accessible; links to a store’s internal theme asset files may not work because they aren’t public.
  • For moving a theme (e.g., an image banner) from one store to another, first host the image at a public URL, then create the asset in the destination theme by referencing that URL in src.

Outcome: Guidance confirms the approach (use a publicly accessible src). Status: No explicit resolution beyond this requirement; implementation details beyond public hosting were not discussed.

Summarized with AI on January 6. AI used: gpt-5.

Am I able to upload images to a shopify store using the REST admin API at all?

is the src in the put asset api for files already existing on the store? Or am I able to include an external URL in this field to upload an image as an asset?

I am wanting to create a system for moving a theme from one shopify store to another. With this, I want to be able to have the image in the image banner on my theme to transfer from one shopify store to the next.

Hi TritonJK - you will need to specify an external URL in the src field to upload an image as an asset, but it will need to be publicly accessible, so a link to themes asset file may not work. You may need to have a publicly accessible URL.