PhotopilotPhotopilot
All integrations
Webshop Medusa

Connect Medusa for text, attributes, and filters

Copy, SEO, and categories automatically in Medusa, per language.

  • Direct connection via the Admin API
Medusa

This is the route

  1. You give Photopilot access to Medusa.
  2. Photopilot matches every product by SKU, EAN, or item number.
  3. Target audience, color, attributes, copy, and SEO are completed and approved.
  4. Everything is in Medusa, by language and ready for your filters.
Explanation

How Photopilot works with Medusa

With Medusa, a team builds its own commerce stack, and product content should not depend on releases. Photopilot connects through the Admin API and fills each product's title, subtitle, description, material, categories, and tags, with target audience, color, and Web only in metadata and images in the right order. This lets the content team keep working on a steady schedule, separate from sprint planning.

What Photopilot retrieves from Medusa

Through the Admin API, Photopilot connects products with title, handle, status, metadata, thumbnail, and images. For each variant, SKU, title, inventory, and its own metadata are included. Each run only picks up products that have been updated since the previous run.

Match by SKU, handle, and EAN

Photopilot matches images to Medusa products using SKU, handle, and an EAN from the variant or product metadata. If the metadata contains your own product number, we use that as the main key. Supplier images that come in by EAN or item number can then find their own way to the right product. Variants with the same color share one image set.

Images and text in Photopilot

Supplier images and packshots are corrected in Photopilot: cut out, cropped, and placed on the background your storefront uses. Where a model photo is missing, Photopilot creates AI model photos or a ghost mannequin, and with Iris as AI creative director, campaign images are created in your brand style. Materials and care symbols are recognized and used in product texts and SEO texts. The content team reviews and approves every product.

Directly in Medusa

Photopilot fills in description and subtitle, puts material in the material field, and adds target group, color, and Web only to the product metadata so your storefront can filter on them. Categories and tags follow your own structure. Images are added in a fixed order, including which image becomes the thumbnail, and each image has alt text. Texts for each language are added to your translation setup in metadata or a module.

Content independent of development releases

In many Medusa projects, product content sits in the same backlog as features, so a new collection has to wait for a release. With Photopilot, that work moves to the content team: new products appear in the worklist automatically, and the overview of missing images shows where action is needed. With autopilot, fixed steps such as creating cut-outs and cropping run without manual work. Reports show how complete the catalog is.

Quick setup, no IT project

You give us the URL of the Medusa backend and an API token with product permissions. Together, we define which metadata keys Photopilot fills and which categories and tags map to your filters. The first run uses your own products right away. After that, Photopilot updates every two hours by default.

Medusa at a glance

What is exchanged
In Medusa, Photopilot fills in title, subtitle, description and material, plus categories, tags and metadata for target audience, color, SEO and Web only. Photopilot adds images to each product in the agreed order.
How often
By default, every two hours, with only the products updated since the previous run. Approved copy and values are sent immediately after approval.
What you provide
The Medusa API URL and a secret API key from Medusa Admin.
Good to know
The integration has been tested against a real Medusa installation in our test lab.

Then in Photopilot

Reliably linked

Let sales-ready content land in your webshop automatically

The StoneBerden FashionRinsma ModepleinVan DijkJeroen BeekmanVan Tilburg Mode & SportDuifhuizenSkiHutBouchier Sport2000Van Dal MannenmodeCalico ClubGentiluomoHarper & YveGenti
300.000+ articles processed
9,5M+ supplier images indexed
~3.200 photos automatically edited per day
FAQ

Frequently Asked Questions

How do I connect Medusa to Photopilot?

Share the URL of your Medusa backend and an API token with access to products. Photopilot tests the connection and runs a first pass on your own products.

Which fields does Photopilot fill in Medusa?

Description, subtitle, and material, categories and tags, and target audience, color, and Web only in metadata. Plus the product images with thumbnail and alt texts.

How do product images from Photopilot get into Medusa?

Photopilot adds the approved images directly to the product. The order and thumbnail are fixed for each product.

Which fields does Photopilot use to match Medusa products?

By SKU, handle, and an EAN from the variant or product metadata. Your own product number in metadata can be used as the primary key.

Does Photopilot work with color and size variants in Medusa?

Yes. Photopilot works with all variants that have an SKU and stock, and groups images by color so sizes in the same color share one image set.

Do I need to install a Medusa plugin for Photopilot?

No. An API token is enough; Photopilot uses the standard Admin API.

Can I approve images and texts before they go into Medusa?

Yes. Everything is reviewed in Photopilot first, and only approved content is sent to Medusa. For each product, you can see what is new or changed.

What if a Medusa product has no supplier photo?

It is then listed in the missing images overview. From a simple product photo, Photopilot creates a packshot, ghost mannequin, or AI model photos, which you review first.

How much do AI model photos cost for a Medusa online store?

AI photos cost €0.05 to €0.21 per photo at queue pricing and are often ready within an hour. Your own AI model with a fixed face costs €1.37.

What does Photopilot fill in Medusa?

Title, subtitle, description, and material; target audience in categories and tags; and color, SEO title, meta description, and Web only in the product metadata.

Does this work with a custom storefront on Medusa?

Yes. The values are stored in Medusa itself, so your storefront reads them like any other product field.

Does existing content in Medusa take precedence?

You choose who wins for each feature: the source or Photopilot. If Photopilot differs, you see a warning on the item.

How often does Photopilot read from Medusa?

Every two hours by default, each time with only the products updated in Medusa.

What does Photopilot need to connect Medusa?

The Medusa API URL and an API token with read and write access to products.

Knowledge base

Read also

Flip the switch

Ready to flip the switch?

Enter your web shop and flip the switch. You'll see how much of your range we get online automatically, with a price estimate and a plan.

How to start

First the trial route, then the technique

The integration is the starting point. After that, Photopilot keeps linking, editing, writing, checking, and publishing together.

  1. What is the source of truth?

    Source, destination, or both: for data, media, and status.

  2. What can be automated?

    Link, crop, and text, or show an exception first.

  3. Where should it go?

    Webshop, FTP, Azure, or API, before anything is built.