PhotopilotPhotopilot
All integrations
Webshop commercetools

Connect commercetools for text, attributes, and filters

Copy, SEO, and product type attributes automatically in commercetools, per language.

  • Direct connection via API
commercetools

This is the route

  1. You give Photopilot access to commercetools.
  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 commercetools, by language and ready for your filters.
Explanation

How Photopilot works with commercetools

In a commercetools setup, product content is spread across product types, variants, assets, and a connected ERP or DAM. Photopilot connects to your project and, for each product, fills the attributes from your product types for target audience, color, material, and Web only, plus description, metaTitle, and metaDescription as a LocalizedString per language, and images per variant.

What Photopilot retrieves from your commercetools project

Photopilot works with your project’s product projections, so it uses exactly what is published. For each product, the key, name and description for each language are included, along with the master variant and variants with SKU and attributes such as EAN, color and material. Existing images and assets are the starting point. Each run filters on lastModifiedAt, so only changed products are picked up.

Variants, colors, and product types

Because commercetools usually stores color and size as variant attributes in a product type, Photopilot matches images by SKU, product key, and EAN. We use a color code from your attributes to group images by color, so each color gets its own set and sizes share the same images. If you use multiple product types, for example for apparel, shoes, and accessories, each type gets its own image rules. This keeps the integration accurate even if the data model grows later.

What Photopilot produces

Supplier images and studio photos automatically get the right background, crop, and aspect ratio for your front shots. Where images are missing, Photopilot creates ghost mannequin images, AI model photos, or complete campaign images with Iris as AI creative director. Materials and care symbols are recognized and form the basis for product texts and SEO texts in every language used in your project. The content team approves everything before it is released.

Directly in your commercetools project

Photopilot fills in target group, color, material, and Web only as enum or lenum attributes according to the attribute definitions of your product types, so the values stay within the allowed choices. Description, metaTitle, and metaDescription are added as a LocalizedString per locale; the slug stays unchanged. Images are added per variant in a fixed order as images, with alt texts.

What the team sees every day

For each variant, Photopilot shows whether there are enough images, which texts are still waiting for approval, and what has already been delivered. New products from the project appear in the worklist automatically, so no one has to track new arrivals manually. With autopilot, recurring steps such as cutouts and cropping can run without manual work. Reports show how complete the content is by brand or category.

Set up in a few steps

You create an API client in the Merchant Center with product permissions and share the project key, API and auth URLs, client ID, and secret. Then we define together which attributes Photopilot fills and which enum values map to your filters. We run the first pass against your own project so the mapping is correct right away. No development project is needed.

commercetools at a glance

What is exchanged
In commercetools, Photopilot fills in description, metaTitle and metaDescription as LocalizedString, plus attributes on your product types for target audience, color, material and Web only. Photopilot adds images to each product in the agreed order.
How often
By default, every two hours, with only the products changed since the previous run. Approved copy and attributes are sent immediately after approval.
What you provide
The project key and an API client with client ID and secret, and access to products and product types.
Good to know
The integration is built on the official commercetools API. We test it together on your project first.

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 commercetools to Photopilot?

Create an API client in the Merchant Center with product permissions and share the project key, API URL, auth URL, client ID, and secret. Photopilot then runs a first pass on your project.

Does Photopilot work with published or staged products in commercetools?

Photopilot uses the published product projections, meaning the data that is also shown on the storefront, and prepares changes for publishing.

Does Photopilot work with variants and color attributes in commercetools?

Yes. Photopilot works with the master variant and variants with an SKU and attributes, and groups images by color. This way, sizes in the same color share one image set.

How do images from Photopilot get into commercetools?

Photopilot adds the approved images as images on the correct variant, in a fixed order, so processing stays predictable.

Does Photopilot create product copy in multiple languages for commercetools?

Yes, for each language your project uses, Photopilot creates product copy, metaTitle, metaDescription, and alt text, and puts them in the localized fields.

Does our development team need to build anything for Photopilot and commercetools?

No. An API client with the right permissions is enough; Photopilot uses the standard commercetools API.

Can I approve content before it is sent to commercetools?

Yes. Images, copy, and attributes are reviewed in Photopilot first and are only sent to commercetools after approval. For each variant, you can see what is new or changed.

What if a commercetools product does not have images yet?

It then appears in the missing images overview. Photopilot can use a simple product photo to create AI model photos, a ghost mannequin, or a packshot, which you then approve yourself.

How often does Photopilot synchronize with commercetools?

Every two hours by default, filtered by lastModifiedAt, so only changed products are processed. This keeps large catalogs easy to maintain.

Which attributes does Photopilot populate in commercetools?

Attributes on your product types for target audience and color (lenum), material (ltext), and Web only (boolean), in every project locale.

Does Photopilot change the slug?

No, the slug stays as it is. Photopilot fills in description, metaTitle, and metaDescription.

Does what’s already in commercetools take priority?

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 commercetools?

Every two hours by default, with only the products changed in the project.

What does Photopilot need to connect commercetools?

The project key and an API client with client ID and secret, and 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.