Shopify

Generate product images, videos and PDFs for your Shopify store, once for your catalog, or each time a product changes

Published ·Updated

The Orshot Shopify app fills your templates with each product's title, price, photos and sale details, then saves the results to the product or to Shopify Files. Run it once for the whole catalog, or turn on a workflow so new and edited products render on their own.

Installing the app#

Orshot installs from the Shopify App Store. There is no store address to type in Orshot.

  1. Open Orshot on the Shopify App Store and click Install
  2. Approve the access Orshot asks for (see Access Orshot asks for)
  3. Shopify sends you to Orshot. Sign up with any email, or log in if you already have an account
  4. The store is linked to your workspace and you land on the Shopify page

To open Orshot later, go to Apps in your Shopify admin and click Orshot. A store that is already linked opens straight in Orshot.

One store links to one Orshot account. A store linked to another account cannot be taken over: log in with that account, or disconnect the store there first.

Billing through Shopify#

If you install Orshot from the App Store and do not already have a paid Orshot subscription, your plan is billed by Shopify:

  • Pick a plan on Shopify's plan page. Manage plan on Shopify in Orshot opens it
  • Charges show on your Shopify bill. Plans and credits are listed on Shopify's plan page
  • Upgrades, downgrades and cancellations are made on Shopify and show in Orshot within minutes
  • Development stores can pick any plan for free

If your account already pays Orshot directly, nothing changes: you keep your current plan and billing, and the store connects as an integration. To be billed through Shopify instead, install the app with a new Orshot account.

Set up a workflow#

Open Shopify in the sidebar of the linked workspace. The page sets up one workflow in three steps:

  1. What should Orshot make?: ad images, social posts, product page images, product videos, sale banners or PDF sheets. Each one saves its files where they work best (see Where files go). Start from a preset fills in the steps for common jobs
  2. Pick a template: Your templates lists every template in your workspace, newest first, each previewed with three of your real products. Shopify templates lists ready-made product designs; Select adds a copy to your workspace, already mapped to your product data. A template that does not use the product parameter names below is mapped to your product data automatically. Map fields on any template card shows that mapping, with each field's type and current content, so you can change what fills each field or keep one as designed. Previews use one render credit each and are kept for a day
  3. Turn it on: choose when a product renders: when it is Added, Edited (title, price, photos or details change), or both. One file per colour or size makes a file for each variant with its own photo and price (Grow and above). The workflow only covers products added or edited from now on; tick Also render existing products once to make files for the products already in your store (all, a collection, a tag or products you pick). The line under it shows products and credits before anything runs. Click Turn on workflow; the confirmation has Open workflow

Your Shopify Workflows are listed under the steps, one row each, with an on/off switch and when each last ran. Runs and logs in a row's menu opens its workflow page with every run and product. Results also show in your Shopify admin and in All Renders.

Plan limits per run#

PlanProducts per runTemplates per runWorkflows on
Free1011
Launch5033
Grow200510
Scale1,00010Unlimited

A larger selection is split into several runs. Each run uses one workflow credit, and each render uses render credits as usual (1 credit per image or PDF page, 1 per video second). A run never starts with more products than your remaining credits cover.

Template parameters#

A template whose parameters use these names fills itself from each product with no mapping step:

ParameterValue
product_titleProduct title
product_image, product_image_2, _3Product photos, main first
product_pricePrice in the store's currency
product_compare_at_priceCompare-at price, only when on sale
product_discount_percentDiscount, for example 20%
product_savingsAmount saved
product_vendor, product_typeVendor and product type
product_colors, product_sizesOption values
product_descriptionDescription as plain text
badge_text, discount_code, shipping_textText you set for the run
brand_logo, brand_color_primaryFrom your brand kit

When a product is not on sale, the compare-at price, discount and savings layers are hidden, so a design's sample "was" price or "% off" never shows. Give a sale badge's shape and labels a parameter starting with sale_ (for example sale_badge) and they hide with it.

Any other template works too: pick it on the Shopify page and map each of its parameters to a product field (title, price, photo, vendor and so on) once. The map is saved with the pick and used for previews, runs and workflows.

Workflows#

Each workflow runs on its own once it is on and counts as one active workflow on your plan. Switch it off or on again from its row in Your Shopify Workflows.

Edits that do not change the product details used by the design, such as reordering media, are skipped, so Orshot's own uploads never trigger another render. Shopify delivers one save several times; Orshot runs once per change. Each run uses one workflow credit.

If you uninstall the app or disconnect the store, its workflows pause. Reinstalling or reconnecting offers to resume them.

Where files go#

DestinationWhat happens
Product mediaAdded to the product after your existing images. Your main image stays first
Files and ads feedSaved to Shopify Files and linked on the product, for the ads feed. Never shown on the product page
Main imageOpt-in for product page images. Replaces the main image; the original is kept for revert
Social accountsPosted to the social accounts connected to the workspace

Ad images, social posts and sale banners never replace the main product image. Google Shopping and Meta catalog ads reject main images with prices, badges or sale text on them, so promo images go to Files and the ads feed instead.

Running the same template again replaces the media Orshot added before for that template, so products do not fill up with duplicates.

Ads feed#

Orshot keeps the latest ad image for each product in a feed for Meta Commerce Manager and Google Merchant Center. Add the feed URL from the Shopify page as a supplementary feed. It lists each product id with its ad image link and refreshes hourly. Your product feed and main images are not changed.

Revert#

The latest one-time run has Revert this run in its row menu. It removes the media that run added and puts back any main image it replaced. Files saved to Shopify Files stay in Files.

Access Orshot asks for#

ScopeWhy
read_products, write_productsRead product details, add media, save Orshot's product fields
read_files, write_filesUpload renders to Shopify Files
read_metaobjectsRead product reviews for review quotes
read_inventoryShow stock labels like "Only a few left"

Orshot does not read orders or customers.

Using Shopify in API requests#

API renders reach Shopify only while Automatic uploads is on. To find it, open Integrations in the Orshot sidebar and click the gear icon on the Shopify card. A store linked from the Shopify App Store starts with Automatic uploads off.

  • Automatic uploads on: every render through the API is also saved to Shopify Files. To send a render somewhere else, such as a product, add connections to the request. A request with its own connections list uses only that list.
  • Automatic uploads off: nothing is sent to Shopify. A connections entry for Shopify fails with the warning Shopify connection is inactive. Enable it in settings.

With Automatic uploads on, you can name Shopify explicitly in connections:

JSON
{
  "templateId": 25,
  "modifications": {
    "headline": "Hello World"
  },
  "response": {
    "type": "url",
    "format": "png"
  },
  "connections": [
    {
      "type": "storage",
      "provider": "shopify"
    }
  ]
}

Uploading as a product image#

To attach the rendered file to a product, turn on Automatic uploads and use the folder parameter with the format product:<productId>:

JSON
{
  "connections": [
    {
      "type": "storage",
      "provider": "shopify",
      "folder": "product:8234567890"
    }
  ]
}

Uploading to Shopify Files#

Without a folder, files go to your store's Shopify Files library, under Content > Files in your Shopify admin.

Custom file names#

Use response.fileName to name the uploaded file:

JSON
{
  "templateId": 25,
  "modifications": { "headline": "Hello" },
  "response": {
    "type": "url",
    "format": "png",
    "fileName": "summer-sale-banner"
  },
  "connections": [
    {
      "type": "storage",
      "provider": "shopify"
    }
  ]
}

API response examples#

Successful upload#

JSON
{
  "data": {
    "content": "https://storage.orshot.com/cloud/w-50/renders/images/abc123.png",
    "type": "url",
    "format": "png",
    "responseTime": 1234.56
  },
  "connections": [
    {
      "type": "storage",
      "provider": "shopify",
      "path": "shopify-files/summer-sale-banner-x8kLm.png",
      "status": "success"
    }
  ]
}

Upload failed (with warning)#

Upload problems return a warning but never block the render:

JSON
{
  "data": {
    "content": "https://storage.orshot.com/cloud/w-50/renders/images/abc123.png",
    "type": "url",
    "format": "png",
    "responseTime": 1234.56
  },
  "warnings": [
    {
      "title": "Failed to upload to shopify: Access denied",
      "details": ""
    }
  ],
  "connections": [
    {
      "type": "storage",
      "provider": "shopify",
      "path": null,
      "status": "error",
      "error": "Access denied"
    }
  ]
}

Shopify not linked#

JSON
{
  "data": {
    "content": "https://storage.orshot.com/cloud/w-50/renders/images/abc123.png",
    "type": "url",
    "format": "png",
    "responseTime": 1234.56
  },
  "warnings": [
    {
      "title": "Failed to upload to shopify: Shopify is not connected. Connect it in workspace settings.",
      "details": ""
    }
  ],
  "connections": [
    {
      "type": "storage",
      "provider": "shopify",
      "path": null,
      "status": "error",
      "error": "Shopify is not connected. Connect it in workspace settings."
    }
  ]
}

If the store is linked but Automatic uploads is off, the same shape comes back with the error Shopify connection is inactive. Enable it in settings.

Connection parameters#

ParameterTypeRequiredDescription
typestringNoOptional. Defaults to "storage"
providerstringYesMust be "shopify"
folderstringNo"product:<productId>" to add the file to a product. Omit to upload to Shopify Files
disabledbooleanNoSet to true to skip this entry

For a Shopify Files upload, path in the response is shopify-files/<fileName>. For a product upload, path is the Shopify file URL. A folder that starts with product: but has no product ID returns the warning Invalid folder format. Use 'product:<productId>' for product images.

Notes#

  • Non-blocking: a failed Shopify upload never blocks the render; you still get the file URL
  • Tokens refresh on their own: you do not need to reconnect unless you uninstall the app
  • Supported formats: PNG, JPG, JPEG, WebP, GIF, MP4, WebM, MOV, MKV and PDF
  • No-code tools: you can also use Zapier, Make or n8n with a Shopify trigger and the Orshot render action

Need help?#

  • Contact support at hi@orshot.com or use the chat button in your Orshot dashboard
Was this page helpful?

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key
  • Image, PDF and video generation via API
  • Visual editor with AI and smart layouts
  • Zapier, Make, MCP and 40+ integrations
  • White-label embed for your own app
  • 100 free credits a month, no credit card required